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INTRODUCTION 


This manual is intended to supplement the information contained in the UNIX System 
User Reference Manual and to provide an easy reference volume for those who must 
administer a UNIX system. Accordingly, only those commands and descriptions deemed 
appropriate for system administrators have been included here. 

This manual is divided into three sections: 

1. System Maintenance Commands and Application Programs 

7. Special Files 

8. System Maintenance Procedures 

Throughout this volume, each reference of the form name(. 1M), named), or named), 
refers to entries in this manual, while all other references to entries of the form 
name{ N), where N is a number possibly followed by a letter, refer to entry name in 
Section N of the UNIX System Programmer Reference Manual or the UNIX System 
User Reference Manual. 

Section 1 ( System Maintenance Commands and Application Programs) contains sys- 
tem maintenance programs such as fsck, mkfs, etc., which generally reside in the direc- 
tory /etc; these entries carry a sub-class designation of “1M” for cross-referencing rea- 
sons. 

Section 7 ( Special Files) discusses the characteristics of each system file that actually 
refers to an input/output device. The names in this section generally refer to device 
names for the hardware, rather than to the names of the special files themselves. 

Section 8 ( System Maintenance Procedures) discusses crash recovery and boot pro- 
cedures, facility descriptions, etc. 

Each section consists of a number of independent entries of a page or so each. The 
name of the entry appears in the upper corners of its pages. Entries within each section 
are alphabetized, with the exception of the introductory entry that begins each section. 
Some entries may describe several routines, commands, etc. In such cases, the entry 
appears only once, alphabetized under its “major” name. 

All entries are based on a common format, not all of whose parts always appear: 

The NAME part gives the name(s) of the entry and briefly states its purpose. 

The SYNOPSIS part summarizes the use of the program being described. A few 
conventions are used, particularly in Section 1 ( Commands ): 

Boldface strings are literals and are to be typed just as they appear. 

Italic strings usually represent substitutable argument prototypes and program 
names found elsewhere in the manual. (They are underlined in the typed ver- 
sion of the entries.) 

Square brackets [] around an argument prototype indicate that the argument 
is optional. When an argument prototype is given as “name” or “file”, it 
always refers to a file name. 

Ellipses ... are used to show that the previous argument prototype may be 
repeated. 

A final convention is used by the commands themselves. An argument begin- 
ning with a minus — , plus +, or equal sign — is often taken to be some sort of 
flag argument, even if it appears in a position where a file name could appear. 
Therefore, it is unwise to have files whose names begin with — , +, or — . 

The DESCRIPTION part discusses the subject at hand. 
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The EXAMPLE (S) part gives example(s) of usage, where appropriate. 

The FILES part gives the file names that are built into the program. 

The SEE ALSO part gives pointers to related information. 

The DIAGNOSTICS part discusses the diagnostic indications that may be produced. 
Messages that are intended to be self-explanatory are not listed. 

The WARNINGS part points out potential pitfalls. 

The BUGS part gives known bugs and sometimes deficiencies. Occasionally, the 
suggested fix is also described. 

A table of contents precedes Section 1. On most systems, all entries are available 
on-line via the man{ 1) command. 
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intro . . introduction to system maintenance commands and application programs 
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fsck file system consistency check and interactive repair 

fscv.vax convert files between PDP-11 and VAX-11/780 systems 

fsdb file system debugger 

fuser identify processes using a file or file structure 

fwtmp manipulate connect accounting records 

getty set terminal type, modes, speed, and line discipline 

init process control initialization 

install install commands 

killall kill all active processes 

link exercise link and unlink system calls 

lpadmin configure the LP spooling system 

lpsched start/stop the LP request scheduler and move requests 

mkboot convert a.out file to boot image 

mkfs construct a file system 

mknod build special file 

mount mount and dismount file system 

mvdir move a directory 

ncheck generate names from i-numbers 

pcldaemon PCL link monitor 

profiler operating system profiler 

pwck password/group file checkers 

qasurvey Quality Assurance Survey 
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runacct run daily accounting 

sadp disk access profiler 

sar system activity report package 

setmnt establish mount table 

shutdown terminate all processing 

sysdef system definition 

tic terminfo compiler 

uuclean uucp spool directory clean-up 

uusub monitor uucp network 

vcf VAX- 11/780 configuration verification program 

vlx VAX-11/780 LSI console floppy interface 

volcopy copy file systems with label checking 

vpmc.dec compiler for the virtual protocol machine 

vpmsave save and print VPM event traces 

vpmset . . . connect/load VPM drivers and programmable communication devices 

vpmtest test KMC lines 

wall write to all users 

whodo who is doing what 

7. Special Files 

intro introduction to special files 

acu Automatic Call Unit (ACU) interface 

dmc communications link with built-in DDCMP protocol 

dmk DM 11 -BA modem control multiplexor 

du DU- 11 synchronous line interface 

dz DZ-11, DZ-1 1/KMC-l IB, DH-11 asynchronous multiplexers 

err error-logging interface 

gd general driver for moving-head disks 

gt general driver for tape drives 

hm RM05 moving-head disk 

hp RP04/RP05/RP06 moving-head disk 

hs RH1 1/RJS03-RJS04 fixed-head disk file 

ht TU16/TE16 magnetic tape interface 

kl KL-11 or DL-11 asynchronous interface 

kmc KMC-1 1B/KMS1 1 microprocessor 

lp line printer 

mem core memory 

mill ML 11 solid-state disk 

null the null file 

pci parallel communications link interface 

prf operating system profiler 

ra RA60/RA80/RA81 moving-head disk 

rf RF11/RS11 fixed-head disk file 

rk RK-1 1/RK03 or RK05 disk 

rl RL-11/RL01 disk 

rm80 RM80 moving-head disk 

rp RP-11/RP03 moving-head disk 

rp07 RP07 non-removable medium moving-head disk 

sxt pseudo-device driver 

termio general terminal interface 

tm TM11/TU10 magnetic tape interface 

trace event-tracing driver 

tsll TS11 magnetic tape interface 

tty controlling terminal interface 

tu78 TU78 magnetic tape interface 

vp Versatec printer 

vpm Virtual Protocol Machine 
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intro introduction to system maintenance procedures 

70boot 1 1/70 bootstrap procedures 

750ops VAX-11/750 console operations 
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crash. dec what to do when the system crashes 
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romboot special ROM bootstrap loaders 

tapeboot magnetic tape bootstrap program 
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PERMUTED INDEX 


70boot: 1 1/70 bootstrap procedures 70boot(8) 

archiver, hpio: HP 2645A terminal tape file hpio(l) 

300: DASI 300 and 300s terminals 300(1) 

terminals. 300: DASI 300 and 300s 300(1) 

300: DASI 300 and 300s terminals 300(1) 

13tol: convert between 3-byte integers and long/ 13tol(3C) 

comparison. diff3: 3-way differential file diff3(l) 

TEKTRONIX 4014 terminal. 4014: paginator for the 4014(1) 

paginator for the TEKTRONIX 4014 terminal. 4014: 4014(1) 

of the DASI 450 terminal. 450: handle special functions 450(1) 

special functions of the DASI 450 terminal. 450: handle 450(1) 

procedures. 70boot: 1 1/70 bootstrap 70boot(8) 

operations. 750ops: VAX- 11/750 console 750ops(8) 

f77: Fortran 77 compiler f77 (1) 

operations. 780ops: VAX-1 1/780 console 780ops(8) 

integer and base-64 ASCII/ a641: convert between long a641(3C) 

abort: generate an IOT fault abort (3C) 

program, abort: terminate Fortran abort(3F) 

abs: Fortran absolute value abs(3F) 

value, abs: return integer absolute abs(3C) 

adb: absolute debugger adb(l) 

abs: return integer absolute value abs(3C) 

abs: Fortran absolute value abs(3F) 

/floor, ceiling, remainder, absolute value functions floor(3M) 

requests, accept: allow/prevent LP accept(lM) 

of a file, touch: update access and modification times touch(l) 

utime: set file access and modification times utime(2) 

accessibility of a file, access: determine access(2) 

commands, graphics: access graphical and numerical .... graphics(lG) 

machine-independent/ sputl: access long integer data in a sputl(3X) 

sadp: disk access profiler sadp(lM) 

ldfcn: common object file access routines ldfcn(4) 

copy file systems for optimal access time, dcopy: dcopy(lM) 

getutent: access utmp file entry getut(3C) 

access: determine accessibility of a file access (2) 

acctdisk: overview of accounting acct(lM) 

enable or disable process accounting, acct: acct(2) 

acctconl: connect-time accounting acctcon(lM) 

acctprcl: process accounting acctprc(lM) 

shell procedures for accounting, chargefee: acctsh(lM) 

diskusg: generate disk accounting data by user ID diskusg(lM) 

acct: per-process accounting file format acct(4) 

search and print process accounting file(s). acctcom: acctcom(l) 

acctmerg: merge or add total accounting files acctmerg(lM) 

mclock: return Fortran time accounting mclock(3F) 

summary from per-process accounting records, /command .... acctcms(lM) 

fwtmp: manipulate connect accounting records fwtmp(lM) 

runacct: run daily accounting runacct(lM) 

process accounting, acct: enable or disable acct (2) 

file format, acct: per-process accounting acct (4) 

per-process accounting/ acctcms: command summary from . . . acctcms(lM) 

process accounting file(s). acctcom: search and print acctcom(l) 

accounting, acctconl: connect-time acctcon(lM) 

accounting acctdisk: overview of acct(lM) 

accounting files, acctmerg: merge or add total acctmerg(lM) 

acctprcl: process accounting acctprc(lM) 

intrinsic function, acos: Fortran arccosine acos(3F) 

killall: kill all active processes killall(lM) 

sag: system activity graph sag(lG) 

sal: system activity report package sar(lM) 

sar: system activity reporter sar(l) 
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current SCCS file editing activity, sact: print sact(l) 

report process data and system activity, /time a command; timex(l) 

interface, acu: Automatic Call Unit (ACU) . . . acu(7) 

acu: Automatic Call Unit (ACU) interface acu (7) 

adb: absolute debugger adb(l) 

acctmerg: merge or add total accounting files acctmerg ( 1 M) 

putenv: change or add value to environment putenv(3C) 

SCCS files, admin: create and administer admin (1) 

admin: create and administer SCCS files admin(l) 

of complex argument, aimag: Fortran imaginary part .... aimag(3F) 

intrinsic function, aint: Fortran integer part aint(3F) 

alarm: set a process alarm clock alarm(2) 

clock, alarm: set a process alarm alarm(2) 

brk: change data segment space allocation brk(2) 

malloc: main memory allocator malloc(3C) 

malloc: fast main memory allocator malloc(3X) 

accept: allow/prevent LP requests accept(lM) 

boolean functions, and, or, xor, not: Fortran bool(3F) 

disk packs, format: format and/or check RP06 and RM05 .... format(lM) 

sort: sort and/or merge files sort(l) 

send: gather files and/or submit RJE jobs send(lC) 

functions, anint: Fortran nearest integer round (3F) 

link editor output, a.out: common assembler and a.out(4) 

mkboot: convert a.out file to boot image mkboot(lM) 

link editor output, a.out: PDP-1 1 assembler and a.out. pdp(4) 

maintainer. ar: archive and library ar.pdp(l) 

maintainer for portable/ ar: archive and library ar(l) 

ar: archive file format ar.pdp(4) 

format, ar: common archive file ar(4) 

language, be: arbitrary-precision arithmetic bc(l) 

acos: Fortran arccosine intrinsic function acos(3F) 

maintainer. ar: archive and library ar.pdp(l) 

for portable archives, ar: archive and library maintainer .... ar(l) 

cpio: format of cpio archive cpio(4) 

ar: common archive file format ar(4) 

ar: archive file format ar.pdp(4) 

common format, arev: convert archive files from PDP-1 1 to arcv.pdp(l) 

ldahread: read the archive header ldahread(3X) 

HP 2645A terminal tape file archiver, hpio: hpio(l) 

tar: tape file archiver tar(l) 

maintainer for portable archives, /archive and library ar(l) 

cpio: copy file archives in and out cpio(l) 

asin: Fortran arcsine intrinsic function asin(3F) 

atan2: Fortran arctangent intrinsic function atan2(3F) 

atan: Fortran arctangent intrinsic function atan(3F) 

from PDP-1 1 to common format, arev: convert archive files arcv.pdp(l) 

imaginary part of complex argument, aimag: Fortran aimag(3F) 

return Fortran command-line argument, getarg: getarg(3F) 

varargs: handle variable argument list varargs(5) 

formatted output of a varargs argument list, vprintf: print vprintf(3S) 

formatted output of a varargs argument list, vprintf: print vprintf(3X) 

command, xargs: construct argument list(s) and execute xargs(l) 

getopt: get option letter from argument vector getopt(3C) 

expr: evaluate arguments as an expression expr(l) 

echo: echo arguments echo(l) 

be: arbitrary-precision arithmetic language bc(l) 

number facts, arithmetic: provide drill in arithmetic(6) 

expr: evaluate arguments as an expression expr(l) 

as: assembler for PDP-1 1 as.pdp(l) 

as: common assembler . as(l) 

characters, asa: interpret ASA carriage control ........ asa(l) 

control characters, asa: interpret ASA carriage asa(l) 

ascii: map of ASCII character set ascii (5) 

set. ascii: map of ASCII character .... ascii(5) 
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long integer and base-64 ASCII string, /convert between .... a641(3C) 

intrinsic function, asin: Fortran arcsine asin(3F) 

help: ask for help help(l) 

output, a.out: common assembler and link editor a.out(4) 

output, a.out: PDP-11 assembler and link editor a.out. pdp(4) 

as: common assembler as(l) 

as: assembler for PDP-1 1 as.pdp(l) 

KMC11B kasb: assembler/un-assembler for the .... kasb(l) 

assertion, assert: verify program assert(3X) 

assert: verify program assertion assert(3X) 

setbuf: assign buffering to a stream setbuf(3S) 

qasurvey: Quality Assurance Survey qasurvey(lM) 

kl: K.L-1 1 or DL-1 1 asynchronous interface kl.pdp(7) 

/DZ-11, DZ-1 1/KMC-l IB, DH-11 asynchronous multiplexers dz(7) 

intrinsic function, atan: Fortran arctangent atan(3F) 

intrinsic function. atan2: Fortran arctangent atan2(3F) 

interface, acu: Automatic Call Unit (ACU) acu(7) 

wait: await completion of process wait(l) 

processing language, awk: pattern scanning and awk(l) 

ungetc: push character back into input stream ungetc(3S) 

back: the game of backgammon. . . . back(6) 

back: the game of backgammon back (6) 

UNIX system file system backup, /daily/weekly filesave(lM) 

fine: fast incremental backup finc(lM) 

free: recover files from a backup tape frec(lM) 

print, initialize, update bad information bdblk: bdblk(lM) 

banner: make posters banner(l) 

terminal capability data base, terminfo: terminfo(4) 

between long integer and base-64 ASCII string, /convert .... a641(3C) 

portions of path names, basename, dirname: deliver basename(l) 

arithmetic language, be: arbitrary-precision bc(l) 

bcopy: interactive block copy bcopy(lM) 

update bad information bdblk: print, initialize, bdblk(lM) 

bdiff: big diff bdiff(l) 

cb: C program beautifier cb(l) 

jO, jl, jn, yO, yl, yn: Bessel functions bessel(3M) 

bfs: big file scanner bfs(l) 

cpset: install object files in binary directories cpset(lM) 

fread: binary input/output fread(3S) 

bsearch: binary search a sorted table bsearch(3C) 

tsearch: manage binary search trees tsearch(3C) 

remove symbols and relocation bits, strip: strip. pdp(l) 

bj: the game of black jack bj(6) 

bj: the game of blackjack bj(6) 

bcopy: interactive block copy bcopy (1M) 

sum: print checksum and block count of a file sum(l) 

sync: update the super block sync(l) 

df: report number of free disk blocks df(lM) 

and, or, xor, not: Fortran boolean functions bool(3F) 

mkboot: convert a.out file to boot image mkboot(lM) 

UNIX system startup and boot procedures, unixboot: unixboot(8) 

romboot: special ROM bootstrap loaders romboot(8) 

70boot: 11/70 bootstrap procedures 70boot(8) 

tapeboot: magnetic tape bootstrap program tapeboot(8) 

diskboot: disk bootstrap programs diskboot(8) 

shell scripts, bre: system initialization brc(lM) 

allocation, brk: change data segment space .... brk(2) 

modest-sized programs, bs: a compiler/interpreter for bs(l) 

sorted table, bsearch: binary search a bsearch (3C) 

stdio: standard buffered input/output package stdio(3S) 

setbuf: assign buffering to a stream setbuf(3S) 

mknod: build special file mknod(lM) 

dmc: communications link with built-in DDCMP protocol dmc(7) 

swab: swap bytes swab(3C) 
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cc: C compiler cc(l) 

programs, see: C compiler for stand-alone scc(l) 

cflow: generate C flow graph cflow(l) 

epp: the C language preprocessor cpp(l) 

cb: C program beautifier cb(l) 

lint: a C program checker lint(l) 

cxref: generate C program cross-reference cxref(l) 

ctrace: C program debugger ctrace(l) 

cal: print calendar cal(l) 

dc: desk calculator dc(l) 

cal: print calendar cal(l) 

calendar: reminder service calendar (1) 

cu: call another UNIX system cu(lC) 

data returned by stat system call, stat: stat(5) 

acu: Automatic Call Unit (ACU) interface acu(7) 

intro: introduction to system calls and error numbers intro(2) 

link and unlink system calls, link: exercise link(lM) 

to an LP line printer. Ip, cancel: send/cancel requests lp(l) 

terminfo: terminal capability data base terminfo(4) 

pnch: file format for card images pnch(4) 

asa: interpret ASA carriage control characters asa(l) 

files, cat: concatenate and print cat(l) 

cb: C program beautifier cb(l) 

cc: C compiler cc(l) 

cd: change working directory cd(l) 

commentary of an SCCS delta, ede: change the delta cdc(l) 

value/ floor: floor, ceiling, remainder, absolute floor(3M) 

cflow: generate C flow graph cfiow(l) 

delta: make a delta (change) to an SCCS file delta (l) 

pipe: create an interprocess channel pipe (2) 

stream, ungetc: push character back into input ungetc(3S) 

user, cuserid: get character login name of the cuserid(3S) 

stream, getc: get character or word from a getc(3S) 

putc: put character or word on a stream putc(3S) 

ascii: map of ASCII character set ascii (5) 

interpret ASA carriage control characters, asa: asa(l) 

toupper: translate characters conv(3C) 

isalpha: classify characters ctype(3C) 

tr: translate characters tr(l) 

for accounting, chargefee: shell procedures acctsh(lM) 

directory, chdir: change working chdir(2) 

fsck: file system consistency check fsck(lM) 

packs, format: format and/or check RP06 and RM05 disk . . . . ! format(lM) 

checking procedure, checkall: faster file system checkall(lM) 

lint: a C program checker lint(l) 

pwck: password/group file checkers pwck(lM) 

checkall: faster file system checking procedure checkall (1M) 

copy file systems with label checking, volcopy: volcopy(lM) 

systems processed by fsck. checklist: list of file checklist^) 

file, sum: print checksum and block count of a .... sum(l) 

chess: the game of chess chess (6) 

chess: the game of chess chess (6) 

times: get process and child process times times (2) 

terminate, wait: wait for child process to stop or wait (2) 

chmod: change mode chmod(l) 

chmod: change mode of file chmod (2) 

of a file, chown: change owner and group .... chown(2) 

chown: change owner or group chown(l) 

chroot: change root directory chroot (2) 

for a command, chroot: change root directory chroot(lM) 

isalpha: classify characters ctype(3C) 

uuclean: uucp spool directory clean-up uuclean(lM) 

clri: clear i-node clri(lM) 

alarm: set a process alarm clock alarm (2) 
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cron: clock daemon cron(lM) 

clock: report CPU time used clock (3C) 

ldclose: close a common object file ldclose(3X) 

close: close a file descriptor close(2) 

descriptor, close: close a file close (2) 

fclose: close or flush a stream fclose(3S) 

clri: clear i-node clri(lM) 

cmp: compare two files cmp(l) 

line-feeds, col: filter reverse col(l) 

comb: combine SCCS deltas comb(l) 

comb: combine SCCS deltas comb(l) 

common to two sorted files, comm: select or reject lines comm(l) 

nice: run a command at low priority nice(l) 

change root directory for a command, chroot: chroot(lM) 

env: set environment for command execution env(l) 

uux: UNIX-to-UNIX system command execution uux(lC) 

system: issue a shell command from Fortran system(3F) 

quits, nohup: run a command immune to hangups and . . . nohup(l) 

net: execute a command on the PCL network net (1C) 

getopt: parse command options getopt(l) 

/shell, the standard/restricted command programming language. . . . sh(l) 

and system/ timex: time a command; report process data timex(l) 

per-process/ acctcms: command summary from acctcms(lM) 

system: issue a shell command system(3S) 

test: condition evaluation command test(l) 

time: time a command time(l) 

argument list(s) and execute command, xargs: construct xargs(l) 

getarg: return Fortran command-line argument getarg(3F) 

at: execute commands at a later time at ( 1 ) 

access graphical and numerical commands, graphics: graphics(lG) 

install: install commands install (1M) 

intro: introduction to commands intro(l) 

introduction to maintenance commands intro: intro(lM) 

how to remake the system and commands, mk: mk(8) 

network useful with graphical commands, stat: statistical stat(lG) 

ede: change the delta commentary of an SCCS delta cdc(l) 

ar: common archive file format ar(4) 

editor output, a.out: common assembler and link a.out(4) 

as: common assembler as( 1 ) 

archive files from PDP-1 1 to common format, arev: convert .... arcv.pdp(l) 

object/archive files to common formats, /convert convert(l) 

function. loglO: Fortran common logarithm intrinsic loglO(3F) 

routines, ldfcn: common object file access ldfcn(4) 

reading, ldopen: open a common object file for ldopen(3X) 

ldclose: close a common object file ldclose(3X) 

read the file header of a common object file, ldfhread: ldfhread(3X) 

seek to the symbol table of a common object file. Idtbseek: ldtbseek(3X) 

line number entries in a common object file, linenum: linenum(4) 

nm: print name list of common object file nm(l) 

relocation information for a common object file, reloc: reloc(4) 

scnhdr: section header for a common object file scnhdr(4) 

table format, syms: common object file symbol syms(4) 

filehdr: file header for common object files filehdr(4) 

Id: link editor for common object files ld(l) 

size: print section sizes of common object files sized ) 

comm: select or reject lines common to two sorted files comm(l) 

ipcs: report inter-process communication facilities/ ipcs(l) 

ftok: standard interprocess communication package stdipc(3C) 

pci: parallel communications link interface pci (7) 

built-in DDCMP protocol, dmc: communications link with dmc(7) 

diff: differential file comparator diff(l) 

cmp: compare two files cmp(l) 

SCCS file, sccsdiff: compare two versions of an sccsdiff(l) 

functions, lge: string comparision intrinsic strcmp(3F) 


- 5 - 



Permuted Index 


diff3: 3-way differential file comparison diff3(l) 

dircmp: directory comparison dircmp(l) 

expression, regcmp: compile and execute regular regcmp(3X) 

regexp: regular expression compile and match routines regexp(5) 

regcmp: regular expression compile regcmp(l) 

term: format of compiled term file term (4) 

cc: C compiler cc(l) 

f77: Fortran 77 compiler f77(l) 

programs, see: C compiler for stand-alone scc(l) 

protocol machine, vpmc: compiler for the virtual vpmc.dec(lM) 

tic: terminfo compiler tic(lM) 

yacc: yet another compiler-compiler yacc(l) 

modest-sized programs, bs: a compiler/interpreter for bs(l) 

erf: error function and complementary error function erf(3M) 

wait: await completion of process wait(l) 

Fortran imaginary part of complex argument, aimag: aimag(3F) 

function, conjg: Fortran complex conjugate intrinsic conjg(3F) 

pack: compress and expand files pack(l) 

table entry of a/ Idtbindex: compute the index of a symbol .... ldtbindex(3X) 

cat: concatenate and print files cat(l) 

test: condition evaluation command test(l) 

system, config: configure a UNIX config.dcO M) 

program, vcf: VAX-1 1/780 configuration verification vcf(lM) 

config: configure a UNIX system config.dc(lM) 

system, lpadmin: configure the LP spooling lpadmin(lM) 

conjugate intrinsic function, conjg: Fortran complex conjg (3F) 

conjg: Fortran complex conjugate intrinsic function conjg(3F) 

fwtmp: manipulate connect accounting records fwtmp(lM) 

KMC11-B dmkset: connect DM1 1 -BA modems to .... dmkset(lM) 

an out-going terminal line connection, dial: establish dial (30 

vpmset: connect/load VPM drivers vpmset(lM) 

acctcon 1 : connect-time accounting acctcon ( 1 M) 

fsck: file system consistency check fsck(lM) 

vlx: VAX-1 1/780 LSI console floppy interface vlx(lM) 

750ops: VAX-1 1/750 console operations 750ops(8) 

780ops: VAX-1 1/780 console operations 780ops(8) 

math: math functions and constants math (5) 

mkfs: construct a file system mkfs(lM) 

execute command, xargs: construct argument list(s) and .... xargs(l) 

Is: list contents of directory ls(l) 

toe: graphical table of contents routines toc(lG) 

esplit: context split csplit(l) 

asa: interpret ASA carriage control characters asa(l) 

ioctl: control device ioctl(2) 

fcntl: file control fcntl(2) 

init: process control initialization init(lM) 

dmk: DM 11 -BA modem control multiplexor dmk(7) 

msgctl: message control operations msgctl(2) 

semctl: semaphore control operations semctl(2) 

shmctl: shared memory control operations shmctl(2) 

fcntl: file control options fcntl(5) 

uucp status inquiry and job control, uustat: uustat(lC) 

vc: version control vc(l) 

interface, tty: controlling terminal tty (7) 

terminals, term: conventional names for term(5) 

int: explicit Fortran type conversion ftype(3F) 

units: conversion program units(l) 

dd: convert and copy a file dd(l) 

image, mkboot: convert a.out file to boot mkboot(lM) 

PDP-1 1 to common/ arev: convert archive files from arcv.pdp(l) 

integers and long/ 13tol: convert between 3-byte 13tol(3C) 

and base-64 ASCII/ a641: convert between long integer a641(3C) 

object/archive files to/ convert: convert convert(l) 

string, ctime: convert date and time to ctime(3C) 
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and VAX-1 1/780 systems, fscv: convert files between PDP- 1 1 fscv.vax(lM) 

to string, ecvt: convert floating-point number ecvt(3C) 

scanf: convert formatted input scanf(3S) 

to common formats, convert: convert object/archive files convert(l) 

double-precision/ strtod: convert string to strtod(3C) 

strtol: convert string to integer strtol(3C) 

dd: convert and copy a file dd (1 ) 

bcopy: interactive block copy bcopy(lM) 

cpio: copy file archives in and out cpio(l) 

access time, dcopy: copy file systems for optimal dcopy(lM) 

checking, volcopy: copy file systems with label volcopy(lM) 

cp, In, mv: copy, link or move files cp(l) 

UNIX system to UNIX system copy, uucp: uucp(lC) 

UNIX-to-UNIX system file copy, uuto: public uuto(lC) 

file, core: format of core image core(4) 

core: format of core image file core (4) 

mem: core memory mem(7) 

function, cos: Fortran cosine intrinsic cos(3F) 

cosine intrinsic function, cosh: Fortran hyperbolic cosh(3F) 

cos: Fortran cosine intrinsic function cos(3F) 

cosh: Fortran hyperbolic cosine intrinsic function cosh(3F) 

sum: print checksum and block count of a file sum(l) 

wc: word count wc(l) 

files, cp, In, mv: copy, link or move cp(l) 

cpio: format of cpio archive cpio (4) 

and out. cpio: copy file archives in cpio(l) 

cpio: format of cpio archive cpio (4) 

preprocessor, cpp: the C language cpp(l) 

binary directories, cpset: install object files in cpset(lM) 

clock: report CPU time used clock(3C) 

craps: the game of craps craps(6) 

craps: the game of craps craps(6) 

crash: examine system images crash(lM) 

system crashes, crash: what to do when the crash.dec(8) 

what to do when the system crashes, crash: crash.dec(8) 

rewrite an existing one. creat: create a new file or creat(2) 

file, tmpnam: create a name for a temporary .... tmpnam(3S) 

an existing one. creat: create a new file or rewrite creat(2) 

fork: create a new process fork(2) 

tmpfile: create a temporary file tmpfile(3S) 

channel, pipe: create an interprocess pipe(2) 

files, admin: create and administer SCCS admin(l) 

umask: set and get file creation mask umask(2) 

cron: clock daemon cron(lM) 

cron tab: user crontab file crontab(l) 

crontab: user crontab file crontab(l) 

cxref: generate C program cross-reference cxref(l) 

optimization package, curses: CRT screen handling and curses(3X) 

crypt: encode/decode crypt(l) 

encryption, crypt: generate DES crypt(3C) 

csplit: context split csplit(l) 

terminal, ct: spawn getty to a remote ct(lC) 

for terminal, ctermid: generate file name ctermid(3S) 

to string, ctime: convert date and time ctime(3C) 

ctrace: C program debugger ctrace(l) 

cu: call another UNIX system cu(lC) 

activity, sact: print current SCCS file editing sact(l) 

uname: print name of current UNIX system uname(l) 

uname: get name of current UNIX system uname(2) 

slot in the utmp file of the current user, /find the ttyslot(3C) 

getcwd: get path-name of current working directory getcwd(3C) 

and optimization package, curses: CRT screen handling curses (3X) 

spline: interpolate smooth curve spline(lG) 

name of the user, cuserid: get character login cuserid(3S) 
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of each line of a file, cut: cut out selected fields cut(l) 

each line of a file, cut: cut out selected fields of cut(l) 

cross-reference, cxref: generate C program cxref(l) 

cron: clock daemon cron(lM) 

errdemon: error-logging daemon errdemon(lM) 

terminate the error-logging daemon, errstop: errstop(lM) 

runacct: run daily accounting runacct(lM) 

system backup, filesave: daily/weekly UNIX system file .... filesave(lM) 

300: DASI 300 and 300s terminals 300(1) 

special functions of the DASI 450 terminal, /handle 450(1) 

/time a command; report process data and system activity timex(l) 

terminfo: terminal capability data base terminfo(4) 

generate disk accounting data by user ID. diskusg: diskusg(lM) 

sputl: access long integer data in a machine-independent/ .... sputl(3X) 

plock: lock process, text, or data in memory plock(2) 

prof: display profile data prof(l) 

call, stat: data returned by stat system stat(5) 

brk: change data segment space allocation brk(2) 

types: primitive system datatypes types (5) 

join: relational database operator join(l) 

tput: query terminfo database tput(l) 

ctime: convert date and time to string ctime(3C) 

date: print and set the date date(l) 

date: print and set the date date(l) 

dc: desk calculator dc(l) 

optimal access time, dcopy: copy file systems for dcopy(lM) 

dd: convert and copy a file dd(l) 

/link with built-in DDCMP protocol dmc(7) 

adb: absolute debugger adb(l) 

ctrace: C program debugger ctrace(l) 

fsdb: file system debugger fsdb(lM) 

sdb: symbolic debugger sdb(l) 

sysdef: system definition sysdef(lM) 

names, basename, dirname: deliver portions of path basename(l) 

file, tail: deliver the last part of a tail(l) 

delta commentary of an SCCS delta, cdc: change the cdc(l) 

file, delta: make a delta (change) to an SCCS delta ( 1 ) 

delta, cdc: change the delta commentary of an SCCS .... cdc(l) 

rmdel: remove a delta from an SCCS file rmdel(l) 

to an SCCS file, delta: make a delta (change) delta (1) 

comb: combine SCCS deltas comb(l) 

mesg: permit or deny messages mesg(l) 

crypt: generate DES encryption crypt (3C) 

close: close a file descriptor close (2) 

dup: duplicate an open file descriptor dup(2) 

dc: desk calculator dc(l) 

file, access: determine accessibility of a access(2) 

file: determine file type file(l) 

master: master device information table master.dec(4) 

ioctl: control device ioctl(2) 

devnm: device name devnm(lM) 

hpd: graphical device routines and filters gdev(lG) 

devnm: device name devnm(lM) 

blocks, df: report number of free disk df(lM) 

dz: DZ-1 1, DZ-1 1/KMC-l 1 B, DH-11 asynchronous/ dz(7) 

terminal line connection, dial: establish an out-going dial (3C) 

ratfor: rational Fortran dialect ratfor(l) 

bdiff: big diff bdiff(l) 

comparator, diff: differential file diff(l) 

comparison. diff3: 3-way differential file diff3(l) 

functions, dim: positive difference intrinsic dim(3F) 

sdiff: side-by-side difference program sdiff(l) 

diffmk: mark differences between files diffmk(l) 

diff: differential file comparator diff(l) 
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diff3: 3-way differential file comparison difT3(l) 

between files, diffmk: mark differences diffmk(l) 

intrinsic functions, dim: positive difference dim(3F) 

dir: format of directories dir (4) 

dircmp: directory comparison dircmp(l) 

install object files in binary directories, cpset: cpset(lM) 

dir: format of directories dir (4) 

rm: remove files or directories rm(l) 

cd: change working directory cd(l) 

chdir: change working directory chdir(2) 

chroot: change root directory chroot(2) 

uuclean: uucp spool directory clean-up uuclean(lM) 

dircmp: directory comparison dircmp(l) 

unlink: remove directory entry unlink(2) 

chroot: change root directory for a command chroot(lM) 

path-name of current working directory, getcwd: get getcwd(3C) 

Is: list contents of directory ls(l) 

mkdir: make a directory mkdir(l) 

mvdir: move a directory mvdir(lM) 

pwd: working directory name pwd(l) 

ordinary file, mknod: make a directory, or a special or mknod(2) 

path names, basename, dirname: deliver portions of basename(l) 

acct: enable or disable process accounting acct(2) 

type, modes, speed, and line discipline, /set terminal getty(lM) 

sadp: disk access profiler sadp(lM) 

ID. diskusg: generate disk accounting data by user diskusg(lM) 

df: report number of free disk blocks df(lM) 

diskboot: disk bootstrap programs diskboot(8) 

RH11/RJS03-RJS04 fixed-head disk file, hs: hs.pdp(7) 

rf: RF11/RS11 fixed-head disk file rf.pdp(7) 

hm: RM05 moving-head disk hm(7) 

moving-head disk. /RP04/RP05/RP06 hp(7) 

mil 1: ML1 1 solid-state disk mlll.pdp(7) 

and/or check RP06 and RM05 disk packs, format: format format(lM) 

rk: RK-1 1/RK.03 or RK05 disk rk.pdp(7) 

rl: RL-1 1/RL01 disk rl(7) 

rm80: RM80 moving-head disk rm80(7) 

medium moving-head disk. /RP07 non-removable rp07(7) 

rp: RP- 11 /RP03 moving-head disk rp.pdp(7) 

du: summarize disk usage du(l) 

programs, diskboot: disk bootstrap diskboot(8) 

general driver for moving-head disks, gd: gd(7) 

accounting data by user ID. diskusg: generate disk diskusg(lM) 

mount: mount and dismount file system mount(lM) 

prof: display profile data prof(l) 

hypot: Euclidean distance function hypot(3M) 

drand48: generate uniformly distributed pseudo-random/ drand48(3C) 

kl: KL-11 or DL-11 asynchronous interface kl.pdp(7) 

multiplexor, dmk: DM1 1 -BA modem control dmk(7) 

dmkset: connect DM1 1-BA modems to KMC1 1-B . . . dmkset(lM) 

built-in DDCMP protocol, dmc: communications link with .... dmc(7) 

multiplexor, dmk: DM 11 -BA modem control .... dmk(7) 

toKMCll-B dmkset: connect DM1 1-BA modems . . dmkset(lM) 

whodo: who is doing what whodo(lM) 

intrinsic function, dprod: double precision product dprod(3F) 

strtod: convert string to double-precision number strtod(3C) 

product intrinsic function, dprod: double precision dprod(3F) 

reversi: a game of dramatic reversals reversi(6) 

distributed pseudo-random/ drand48: generate uniformly drand48(3C) 

graph: draw a graph graph(lG) 

arithmetic: provide drill in number facts arithmetic(6) 

gd: general driver for moving-head disks gd(7) 

gt: general driver for tape drives gt(7) 

sxt: pseudo-device driver sxt(7) 


- 9 - 



Permuted Index 


trace: event-tracing driver trace(7) 

vpmset: connect/load VPM drivers vpmset(lM) 

gt: general driver for tape drives gt(7) 

interface, du: DU- 1 1 synchronous line du.pdp(7) 

du: summarize disk usage du(l) 

interface, du: DU-11 synchronous line du.pdp(7) 

an object file, dump: dump selected parts of dump(l) 

extract error records from dump, errdead: errdead(lM) 

od: octal dump od(l) 

object file, dump: dump selected parts of an dump(l) 

descriptor, dup: duplicate an open file dup(2) 

descriptor, dup: duplicate an open file dup(2) 

DH-1 1 asynchronous/ dz: DZ-11, DZ-ll/KMC-1 IB dz(7) 

asynchronous/ dz: DZ-1 1, DZ-1 1/KMC-l IB, DH-1 1 . . dz(7) 

asynchronous/ dz: DZ-1 1, DZ-1 1/KMC-l IB, DH-1 1 dz(7) 

echo: echo arguments echo(l) 

echo: echo arguments echo(l) 

number to string, ecvt: convert floating-point ecvt(3C) 

ed, red: text editor ed(l) 

edit: text editor edit(l) 

sact: print current SCCS file editing activity sact(l) 

ed, red: text editor ed ( 1 ) 

edit: text editor edit(l) 

ex: text editor ex(l) 

files. Id: link editor for common object ld(l) 

ged: graphical editor ged(lG) 

Id: link editor ld.pdp(l) 

common assembler and link editor output, a.out: a.out(4) 

PDP-1 1 assembler and link editor output, a.out: a.out. pdp(4) 

sed: stream editor sed(l) 

vi: screen-oriented editor vi ( 1 ) 

Language, efl: Extended Fortran efl(l) 

fsplit: split f77, ratfor, or efl files fsplit(l) 

printers, enable: enable/disable LP enable(l) 

accounting, acct: enable or disable process acct(2) 

enable: enable/disable LP printers enable(l) 

crypt: encode/decode crypt ( 1 ) 

crypt: generate DES encryption crypt(3C) 

makekey: generate encryption key makekey(l) 

program, end: last locations in end(3C) 

trenter: enter a trouble report trenter(l) 

nlist: get entries from name list nlist(3C) 

file, linenum: line number entries in a common object linenum(4) 

man: print entries in this manual man(l) 

/manipulate line number entries of a file function ldlread(3X) 

ldlseek: seek to line number entries of a section of a/ ldlseek(3X) 

ldrseek: seek to relocation entries of a section of a/ ldrseek(3X) 

utmp: utmp and wtmp entry formats utmp(4) 

getgrent: get group file entry getgrent(3C) 

getpwent: get password file entry getpwent(3C) 

getutent: access utmp file entry getut(3C) 

name for file symbol table entry, /retrieve symbol ldgetname(3X) 

the index of a symbol table entry of a file, /compute ldtbindex(3X) 

read an indexed symbol table entry of a file, ldtbread: ldtbread(3X) 

putpwent: write password file entry putpwent(3C) 

rje: RJE (Remote Job Entry) to IBM rje(8) 

unlink: remove directory entry unlink(2) 

command execution, env: set environment for env(l) 

environ: user environment environ(5) 

profile: setting up an environment at login time profile(4) 

environ: user environment environ (5) 

execution, env: set environment for command env(l) 

getenv: return value for environment name getenv(3C) 

putenv: change or add value to environment putenv(3C) 
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getenv: return Fortran environment variable getenv(3F) 

sky: obtain ephemerides sky (6) 

complementary error function, erf: error function and erf(3M) 

err: error-logging interface err(7) 

from dump, errdead: extract error records errdead(lM) 

daemon, errdemon: error-logging errdemon(lM) 

format, errfile: error-log file errfile(4) 

complementary error/ erf: error function and erf(3M) 

function and complementary error function, erf: error erf(3M) 

perror: system error messages perror(3C) 

to system calls and error numbers, /introduction intro(2) 

errdead: extract error records from dump errdead(lM) 

matherr: error-handling function matherr(3M) 

errfile: error-log file format errfile(4) 

errdemon: error-logging daemon errdemon (1M) 

errstop: terminate the error-logging daemon errstop(lM) 

err: error-logging interface err(7) 

process a report of logged errors, errpt: errpt(lM) 

spell: find spelling errors spell(l) 

logged errors, errpt: process a report of errpt(lM) 

error-logging daemon, errstop: terminate the errstop(lM) 

terminal line/ dial: establish an out-going dial(3C) 

setmnt: establish mount table setmnt(lM) 

hypot: Euclidean distance function hypot(3M) 

expression, expr: evaluate arguments as an expr(l) 

test: condition evaluation command test(l) 

vpmsave: save and print VPM event traces vpmsave(lM) 

trace: event-tracing driver trace(7) 

ex: text editor ex(l) 

crash: examine system images crash (1M) 

execl: execute a file exec(2) 

network, net: execute a command on the PCL .... net(lC) 

execl: execute a file exec (2) 

construct argument list(s) and execute command, xargs: xargs(l) 

time, at: execute commands at a later at (1 ) 

regcmp: compile and execute regular expression regcmp(3X) 

set environment for command execution, env: env(l) 

sleep: suspend execution for an interval sleep(l) 

sleep: suspend execution for interval sleep(3C) 

monitor: prepare execution profile monitor(3C) 

profil: execution time profile profil(2) 

UNIX-to-UNIX system command execution, uux: uux(lC) 

system calls, link: exercise link and unlink link(lM) 

a new file or rewrite an existing one. creat: create creat(2) 

exit: terminate process exit(2) 

power, square root functions, exp: exponential, logarithm, exp(3M) 

intrinsic function, exp: Fortran exponential exp(3F) 

pack: compress and expand files pack(l) 

conversion, int: explicit Fortran type ftype(3F) 

function, exp: Fortran exponential intrinsic exp(3F) 

square root functions, exp: exponential, logarithm, power, .... exp(3M) 

expression, expr: evaluate arguments as an .... expr(l) 

routines, regexp: regular expression compile and match regexp(5) 

regcmp: regular expression compile regcmp(l) 

expr: evaluate arguments as an expression expr(l) 

compile and execute regular expression, regcmp: regcmp(3X) 

efl: Extended Fortran Language efl(l) 

dump, errdead: extract error records from errdead (1M) 

f77: Fortran 77 compiler f77 (l) 

fsplit: split f77, ratfor, or efl files fsplit(l) 

factor: factor a number factor(l) 

factor: factor a number factor(l) 

data in a machine-independent fashion /access long integer sputl(3X) 

fine: fast incremental backup finc(l M) 
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malloc: fast main memory allocator malloc(3X) 

procedure, checkall: faster file system checking checkall(lM) 

abort: generate an IOT fault abort (3C) 

stream, fclose: close or flush a fclose(3S) 

fcntl: file control fcntl(2) 

fcntl: file control options fcntl (5) 

inquiries, ferror: stream status ferror(3S) 

statistics for a file system, ff: list file names and fT(lM) 

times, utime: set file access and modification utime(2) 

ldfcn: common object file access routines ldfcn(4) 

determine accessibility of a file, access: access (2) 

hpio: HP 2645A terminal tape file archiver hpio(l) 

tar: tape file archiver tar(l) 

cpio: copy file archives in and out cpio(l) 

pwck: password/group file checkers pwck(lM) 

chmod: change mode of file chmod(2) 

change owner and group of a file, chown: chown(2) 

diff: differential file comparator diff(l) 

diff3: 3-way differential file comparison difT3 ( 1 ) 

fcntl: file control fcntl(2) 

fcntl: file control options fcntl (5) 

public UNIX-to-UNIX system file copy, uuto: uuto(lC) 

core: format of core image file core (4) 

umask: set and get file creation mask umask(2) 

crontab: user crontab file crontab(l) 

fields of each line of a file, cut: cut out selected cut(l) 

dd: convert and copy a file dd(l) 

a delta (change) to an SCCS file, delta: make delta (1 ) 

close: close a file descriptor close (2) 

dup: duplicate an open file descriptor dup(2) 

file: determine file type file (1 ) 

selected parts of an object file, dump: dump dump(l) 

sact: print current SCCS file editing activity sact(l) 

getgrent: get group file entry getgrent(3C) 

getpwent: get password file entry getpwent(3C) 

getutent: access utmp file entry getut(3C) 

putpwent: write password file entry putpwent(3C) 

execl: execute a file exec(2) 

grep: search a file for a pattern grep(l) 

ldopen: open a common object file for reading ldopen(3X) 

acct: per-process accounting file format acct(4) 

ar: common archive file format ar(4) 

ar: archive file format ar.pdp(4) 

errfile: error-log file format errfile(4) 

pnch: file format for card images pnch(4) 

intro: introduction to file formats intro(4) 

line number entries of a file function, /manipulate ldlread(3X) 

get: get a version of an SCCS file get(l) 

group: group file group (4) 

files, filehdr: file header for common object filehdr(4) 

file, ldfhread: read the file header of a common object .... ldfhread(3X) 

ldohseek: seek to the optional file header of a file ldohseek(3X) 

fixed-head disk file, hs: RH1 1/RJS03-RJS04 hs.pdp(7) 

split: split a file into pieces split (l) 

issue: issue identification file issue (4) 

ldclose: close a common object file ldclose(3X) 

file header of a common object file, ldfhread: read the ldfhread (3X) 

entries of a section of a file, /seek to line number ldlseek(3X) 

the optional file header of a file, ldohseek: seek to ldohseek(3X) 

entries of a section of a file, /seek to relocation ldrseek(3X) 

section header of a file, /read an indexed/named ldshread(3X) 

section of an object file, /to an indexed/named ldsseek(3X) 

of a symbol table entry of a file, /compute the index ldtbindex(3X) 

symbol table entry of a file, /read an indexed ldtbread(3X) 
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table of a common object file, /seek to the symbol ldtbseek(3X) 

entries in a common object file, linenum: line number linenum(4) 

link: link to a file link(2) 

mknod: build special file mknod(lM) 

or a special or ordinary file, /make a directory, mknod (2) 

ctermid: generate file name for terminal ctermid(3S) 

mktemp: make a unique file name mktemp(3C) 

a file system, ff: list file names and statistics for ff(lM) 

change the format of a text file, newform: newform(l) 

name list of common object file, nm: print nm(l) 

null: the null file null (7) 

/find the slot in the utmp file of the current user ttyslot(3C) 

/identify processes using a file or file structure fuser(lM) 

one. creat: create a new file or rewrite an existing creat(2) 

passwd: password file passwd(4) 

merge same lines of several file paste: paste(l) 

soft-copy terminals, pg: file perusal filter for pg(l) 

fseek: reposition a file pointer in a stream fseek(3S) 

lseek: move read/write file pointer lseek(2) 

prs: print an SCCS file prs(l) 

read: read from file read (2) 

for a common object file, /relocation information reloc(4) 

rf: RF1 1/RSI 1 fixed-head disk file rf.pdp(7) 

remove a delta from an SCCS file, rmdel: rmdel(l) 

bfs: big file scanner bfs(l) 

two versions of an SCCS file. sccsdifT: compare sccsdiff(l) 

sccsfile: format of SCCS file sccsfile(4) 

header for a common object file, scnhdr: section scnhdr(4) 

stat: get file status stat(2) 

line number information from a file, strip: strip symbol and strip(l) 

processes using a file or file structure, /identify fuser(lM) 

checksum and block count of a file, sum: print sum(l) 

/retrieve symbol name for file symbol table entry ldgetname(3X) 

syms: common object file symbol table format syms(4) 

daily/weekly UNIX system file system backup, filesave: filesave(lM) 

procedure, checkall: faster file system checking checkall(lM) 

fsck: file system consistency check fsck(lM) 

fsdb: file system debugger fsdb(lM) 

names and statistics for a file system, ff: list file ff(lM) 

volume, file system: format of system fs(4) 

mkfs: construct a filesystem mkfs(lM) 

mount: mount and dismount filesystem mount(lM) 

mount: mount a file system mount (2) 

ustat: get file system statistics ustat(2) 

mnttab: mounted file system table mnttab(4) 

umount: unmount a file system umount(2) 

access time, dcopy: copy file systems for optimal dcopy(lM) 

fsck. checklist: list of file systems processed by checklist (4) 

checking, volcopy: copy file systems with label volcopy(lM) 

deliver the last part of a file, tail: tail(l) 

term: format of compiled term file term(4) 

tmpfile: create a temporary file tmpfile(3S) 

create a name for a temporary file, tmpnam: tmpnam(3S) 

mkboot: convert a.out file to boot image mkboot(lM) 

and modification times of a file, touch: update access touch(l) 

ftw: walk a file tree ftw(3C) 

file: determine file type file(l) 

undo a previous get of an SCCS file, unget: unget(l) 

report repeated lines in a file, uniq: uniq(l) 

val: validate SCCS file val(l) 

write: write on a file write (2) 

umask: set file-creation mode mask umask(l) 

common object files, filehdr: file header for filehdr(4) 

and print process accounting file(s). acctcom: search acctcom(l) 
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merge or add total accounting files, acctmerg: acctmerg(lM) 

create and administer SCCS files, admin: admin(l) 

send: gather files and/or submit RJE jobs send(lC) 

VAX-11/780/ fsev: convert files between PDP-1 1 and fscv.vax(lM) 

cat: concatenate and print files cat(l) 

emp: compare two files cmp(l) 

lines common to two sorted files, comm: select or reject comm(l) 

cp, In, mv: copy, link or move files cp(l) 

mark differences between files, diffmk: diffmk(l) 

file header for common object files, filehdr: filehdr(4) 

find: find files find(l) 

free: recover files from a backup tape frec(lM) 

format, arev: convert archive files from PDP-1 1 to common arcv.pdp(l) 

format specification in text files, fspec: fspec(4) 

split f77, ratfor, or efl files, fsplit: fsplit(l) 

string, format of graphical files, /graphical primitive gps(4) 

cpset: install object files in binary directories cpset(lM) 

intro: introduction to special files intro(7) 

link editor for common object files. Id: Id ( 1 ) 

rm: remove files or directories rm(l) 

pack: compress and expand files pack(l) 

pr: print files pr(l) 

section sizes of common object files, size: print size(l) 

size: print sizes of object files size.pdp(l) 

sort: sort and/or merge files sort (1 ) 

/convert object/archive files to common formats convert(l) 

what: identify SCCS files what(l) 

system file system backup, filesave: daily /weekly UNIX filesave(lM) 

terminals, pg: file perusal filter for soft-copy pg ( 1 ) 

greek: select terminal filter greek(l) 

nl: line numbering filter nl (1) 

col: filter reverse line-feeds col(l) 

graphical device routines and filters, hpd: gdev(lG) 

tplot: graphics filters tplot(lG) 

fine: fast incremental backup finc(lM) 

find: find files find(l) 

find: find files find(l) 

ttyname: find name of a terminal ttyname(3C) 

object library, lorder: find ordering relation for an lorder(l) 

spell: find spelling errors spell (1) 

of the current user, ttyslot: find the slot in the utmp file ttyslot(3C) 

tee: pipe fitting tee(l) 

hs: RH1 1/RJS03-RJS04 fixed-head disk file hs.pdp (7) 

rf: RF1 1/RSI 1 fixed-head disk file rf.pdp(7) 

string, ecvt: convert floating-point number to ecvt(3C) 

frexp: manipulate parts of floating-point numbers frexp(3C) 

absolute value/ floor: floor, ceiling, remainder, floor(3M) 

remainder, absolute value/ floor: floor, ceiling, floor(3M) 

vlx: VAX-1 1/780 LSI console floppy interface vlx(lM) 

cflow: generate C flow graph cflow(l) 

fclose: close or flush a stream fclose(3S) 

fopen: open a stream fopen(3S) 

fork: create a new process fork (2) 

per-process accounting file format, acct: acct(4) 

RM05 disk packs, format: format and/or check RP06 and .... format(lM) 

ar: common archive file format ar(4) 

files from PDP-1 1 to common format, arev: convert archive arcv.pdp(l) 

ar: archive file format ar.pdp(4) 

errfile: error-log file format errfile(4) 

pnch: file format for card images pnch(4) 

RP06 and RM05 disk packs, format: format and/or check format(lM) 

newform: change the format of a text file newform(l) 

inode: format of an i-node inode(4) 

term: format of compiled term file term (4) 
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core: format of core image file core (4) 

cpio: format of cpio archive cpio(4) 

dir: format of directories dir (4) 

/graphical primitive string, format of graphical files gps(4) 

sccsfile: format of SCCS file sccsfile(4) 

file system: format of system volume fs (4) 

files, fspec: format specification in text fspec(4) 

object file symbol table format, syms: common syms(4) 

object/archive files to common formats, convert: convert convert(l) 

intro: introduction to file formats intro(4) 

utmp: utmp and wtmp entry formats utmp(4) 

scanf: convert formatted input scanf(3S) 

argument list, vprintf: print formatted output of a varargs vprintf(3S) 

argument list, vprintf: print formatted output of a varargs vprintf(3X) 

printf: print formatted output printf (3S) 

f77: Fortran 77 compiler f77(l) 

abs: Fortran absolute value abs(3F) 

system/ signal: specify Fortran action on receipt of a signal(3F) 

function, acos: Fortran arccosine intrinsic acos(3F) 

function, asin: Fortran arcsine intrinsic asin(3F) 

function. atan2: Fortran arctangent intrinsic atan2(3F) 

function, atan: Fortran arctangent intrinsic atan(3F) 

and, or, xor, not: Fortran boolean functions bool(3F) 

getarg: return Fortran command-line argument. . . . getarg(3F) 

intrinsic function. loglO: Fortran common logarithm loglO(3F) 

intrinsic function, conjg: Fortran complex conjugate conjg(3F) 

function, cos: Fortran cosine intrinsic cos(3F) 

ratfor: rational Fortran dialect ratfor(l) 

getenv: return Fortran environment variable getenv(3F) 

function, exp: Fortran exponential intrinsic exp(3F) 

intrinsic function, cosh: Fortran hyperbolic cosine cosh(3F) 

intrinsic function, sinh: Fortran hyperbolic sine sinh(3F) 

intrinsic function, tanh: Fortran hyperbolic tangent tanh(3F) 

complex argument, aimag: Fortran imaginary part of aimag(3F) 

function, aint: Fortran integer part intrinsic aint(3F) 

efl: Extended Fortran Language efl(l) 

functions, max: Fortran maximum-value max(3F) 

functions, min: Fortran minimum-value min(3F) 

intrinsic function, log: Fortran natural logarithm log(3F) 

functions, anint: Fortran nearest integer round(3F) 

abort: terminate Fortran program abort(3F) 

functions, mod: Fortran remaindering intrinsic .... mod(3F) 

function, sin: Fortran sine intrinsic sin(3F) 

function, sqrt: Fortran square root intrinsic sqrt(3F) 

len: return length of Fortran string len(3F) 

index: return location of Fortran substring index(3F) 

issue a shell command from Fortran, system: system(3F) 

function, tan: Fortran tangent intrinsic tan(3F) 

mclock: return Fortran time accounting mclock(3F) 

intrinsic function, sign: Fortran transfer-of-sign sign(3F) 

int: explicit Fortran type conversion ftype(3F) 

fread: binary input/output fread(3S) 

backup tape, free: recover files from a frec(lM) 

df: report number of free disk blocks df(lM) 

floating-point numbers, frexp: manipulate parts of frexp(3C) 

free: recover files from a backup tape freed M) 

and line number information from a file, /strip symbol strip(l) 

getc: get character or word from a stream getc(3S) 

gets: get a string from a stream gets(3S) 

rmdel: remove a delta from an SCCS file rmdel(l) 

getopt: get option letter from argument vector getopt(3C) 

errdead: extract error records from dump errdead(lM) 

read: read from file read (2) 

system: issue a shell command from Fortran system(3F) 
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nchcck: generate names from i-numbers ncheck(lM) 

nlist: get entries from name list nlist(3C) 

arev: convert archive files from PDP-1 1 to common format. . . . arcv.pdp(l) 

acctcms: command summary from per-process accounting/ acctcms(lM) 

getpw: get name from UID getpw(3C) 

of file systems processed by fsek. checklist: list checklist(4) 

check fsck: file system consistency fsck(lM) 

PDP-1 1 and VAX-1 1/780/ fsev: convert files between fscv.vax(lM) 

fsdb: file system debugger fsdb(lM) 

pointer in a stream, fseek: reposition a file fseek(3S) 

text files, fspec: format specification in fspec(4) 

efl files, fsplit: split f77, ratfor, or fsplit(l) 

communication package, ftok: standard interprocess stdipc(3C) 

ftw: walk a file tree ftw(3C) 

Fortran arccosine intrinsic function, acos: acos(3F) 

Fortran integer part intrinsic function, aint: aint(3F) 

error function, erf: error function and complementary erf(3M) 

Fortran arcsine intrinsic function, asin: asin(3F) 

Fortran arctangent intrinsic function. atan2: atan2(3F) 

Fortran arctangent intrinsic function, atan: atan(3F) 

complex conjugate intrinsic function, conjg: Fortran conjg(3F) 

cos: Fortran cosine intrinsic function cos(3F) 

hyperbolic cosine intrinsic function, cosh: Fortran cosh(3F) 

precision product intrinsic function, dprod: double dprod(3F) 

and complementary error function, erf: error function erf(3M) 

Fortran exponential intrinsic function, exp: exp(3F) 

gamma: log gamma function gamma (3M) 

hypot: Euclidean distance function hypot(3M) 

line number entries of a file function, ldlread: manipulate ldlread(3X) 

common logarithm intrinsic function. loglO: Fortran logl0(3F) 

natural logarithm intrinsic function, log: Fortran log(3F) 

matherr: error-handling function matherr(3M) 

prof: profile within a function prof(5) 

transfer-of-sign intrinsic function, sign: Fortran sign(3F) 

sin: Fortran sine intrinsic function sin(3F) 

hyperbolic sine intrinsic function, sinh: Fortran sinh(3F) 

Fortran square root intrinsic function, sqrt: sqrt(3F) 

tan: Fortran tangent intrinsic function tan(3F) 

hyperbolic tangent intrinsic function, tanh: Fortran tanh(3F) 

math: math functions and constants math(5) 

jO, jl, jn, yO, yl, yn: Bessel functions bessel(3M) 

or, xor, not: Fortran boolean functions, and, bool(3F) 

positive difference intrinsic functions, dim: dim(3F) 

logarithm, power, square root functions, exp: exponential, exp(3M) 

remainder, absolute value functions, /floor, ceiling, floor(3M) 

max: Fortran maximum-value functions max(3F) 

min: Fortran minimum-value functions min(3F) 

Fortran remaindering intrinsic functions, mod: mod(3F) 

hp: handle special functions of HP terminals hp(l) 

terminal. 450: handle special functions of the DASI 450 450(1) 

anint: Fortran nearest integer functions round(3F) 

sinh: hyperbolic functions sinh(3M) 

string comparision intrinsic functions, lge: strcmp(3F) 

sin: trigonometric functions trig(3M) 

using a file or file/ fuser: identify processes fuser(lM) 

accounting records, fwtmp: manipulate connect fwtmp(lM) 

jotto: secret word game jotto(6) 

moo: guessing game moo (6) 

back: the game of backgammon back(6) 

bj: the game of black jack bj (6) 

chess: the game of chess. chess(6) 

craps: the game of craps craps(6) 

reversi: a game of dramatic reversals reversi(6) 

wump: the game of hunt-the-wumpus wump(6) 
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intro: introduction to games intro(6) 

gamma: log gamma function gamma(3M) 

gamma: log gamma function gamma(3M) 

jobs, send: gather files and/or submit RJE .... send(lC) 

moving-head disks, gd: general driver for gd(7) 

ged: graphical editor ged(lG) 

maze: generate a maze maze (6) 

abort: generate an IOT fault abort(3C) 

cflow: generate C flow graph cflow(l) 

cross-reference, cxref: generate C program cxref(l) 

crypt: generate DES encryption crypt(3C) 

by user ID. diskusg: generate disk accounting data diskusg(lM) 

makekey: generate encryption key makekey(l) 

terminal, ctermid: generate file name for ctermid(3S) 

ncheck: generate names from i-numbers ncheck(lM) 

lexical tasks, lex: generate programs for simple lex(l) 

pseudo-random/ drand48: generate uniformly distributed .... drand48(3C) 

rand: simple random-number generator rand(3C) 

irand: random number generator rand(3F) 

gets: get a string from a stream gets(3S) 

get: get a version of an SCCS file get(l) 

ulimit: get and set user limits ulimit(2) 

the user, cuserid: get character login name of cuserid(3S) 

stream, getc: get character or word from a getc(3S) 

nlist: get entries from name list nlist(3C) 

umask: set and get file creation mask umask(2) 

stat: get file status stat(2) 

ustat: get file system statistics ustat(2) 

file, get: get a version of an SCCS get(l) 

getgrent: get group file entry getgrent(3C) 

getlogin: get login name getlogin (3C) 

logname: get login name logname(l) 

msgget: get message queue msgget(2) 

getpw: get name from UID getpw(3C) 

system, uname: get name of current UNIX uname(2) 

unget: undo a previous get of an SCCS file unget(l) 

argument vector, getopt: get option letter from getopt(3C) 

getpwent: get password file entry getpwent(3C) 

working directory, getewd: get path-name of current getcwd(3C) 

times, times: get process and child process times(2) 

and parent process/ getpid: get process, process group, getpid (2) 

semget: get set of semaphores semget(2) 

shmget: get shared memory segment shmget(2) 

tty: get the name of the terminal tty(l) 

time: get time time(2) 

getuid: get user IDs getuid(2) 

command-line argument, getarg: return Fortran getarg(3F) 

from a stream, getc: get character or word getc(3S) 

current working directory, getewd: get path-name of getcwd(3C) 

environment variable, getenv: return Fortran getenv(3F) 

environment name, getenv: return value for getenv (3C) 

entry, getgrent: get group file getgrent(3C) 

getlogin: get login name getlogin (3C) 

argument vector, getopt: get option letter from getopt(3C) 

getopt: parse command options getopt(l) 

getpass: read a password getpass(3C) 

group, and parent process/ getpid: get process, process getpid (2) 

getpw: get name from UID getpw(3C) 

entry, getpwent: get password file getpwent(3C) 

stream, gets: get a string from a gets(3S) 

and terminal settings used by getty. gettydefs: speed gettydefs(4) 

modes, speed, and line/ getty: set terminal type getty (1M) 

ct: spawn getty to a remote terminal ct(lC) 

settings used by getty. gettydefs: speed and terminal gettydefs(4) 
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getuid: get user IDs getuid(2) 

entry, getutent: access utmp file getut(3C) 

setjmp: non-local goto setjmp(3C) 

string, format of graphical/ gps: graphical primitive gps(4) 

cflow: generate C flow graph cflow(l) 

graph: draw a graph graph (1G) 

graph: draw a graph graph(lG) 

sag: system activity graph sag(lG) 

commands, graphics: access graphical and numerical graphics(lG) 

/network useful with graphical commands stat(lG) 

filters, hpd: graphical device routines and gdev(lG) 

ged: graphical editor ged(lG) 

primitive string, format of graphical files, /graphical gps(4) 

format of graphical/ gps: graphical primitive string gps(4) 

routines, toe: graphical table of contents toc(lG) 

gutil: graphical utilities gutil(lG) 

numerical commands, graphics: access graphical and .... graphics(lG) 

tplot: graphics filters tplot(lG) 

plot: graphics interface plot (4) 

subroutines, plot: graphics interface plot(3X) 

greek: select terminal filter greek(l) 

pattern, grep: search a file for a grep(l) 

getpid: get process, process group, and parent process IDs getpid(2) 

chown: change owner or group chown(l) 

getgrent: get group file entry getgrent(3C) 

group: group file group(4) 

group: group file group (4) 

setpgrp: set process group ID setpgrp(2) 

id: print user and group IDs and names id(l) 

setuid, setgid: set user and group IDs setuid (2) 

newgrp: log in to a new group newgrp(l) 

chown: change owner and group of a file chown (2) 

a signal to a process or a group of processes, /send kill (2) 

update, and regenerate groups of programs, /maintain make(l) 

drives, gt: general driver for tape gt(7) 

hangman: guess the word hangman (6) 

moo: guessing game moo (6) 

gutil: graphical utilities gutil (1 G) 

terminals, hp: handle special functions of HP .... hp(l) 

the DASI 450 terminal. 450: handle special functions of 450(1) 

varargs: handle variable argument list varargs(5) 

package, curses: CRT screen handling and optimization curses(3X) 

hangman: guess the word hangman (6) 

nohup: run a command immune to hangups and quits nohup(l) 

hsearch: manage hash search tables hsearch(3C) 

file, scnhdr: section header for a common object scnhdr(4) 

files, filehdr: file header for common object filehdr(4) 

Idahread: read the archive header ldahread(3X) 

file, ldfhread: read the file header of a common object ldfhread(3X) 

seek to the optional file header of a file, ldohseek: ldohseek(3X) 

read an indexed/named section header of a file, ldshread: ldshread(3X) 

help: ask for help help(l) 

help: ask for help help(l) 

hm: RM05 moving-head disk hm(7) 

archiver, hpio: HP 2645A terminal tape file hpio(l) 

of HP terminals, hp: handle special functions hp(l) 

moving-head disk, hp: RP04/RP05/RP06 hp(7) 

handle special functions of HP terminals, hp: hp(l) 

and filters, hpd: graphical device routines gdev(lG) 

file archiver, hpio: HP 2645A terminal tape .... hpio(l) 

fixed-head disk file, hs: RH11/RJS03-RJS04 hs.pdp(7) 

tables, hsearch: manage hash search hsearch(3C) 

interface, ht: TUI 6/TE 16 magnetic tape .... ht(7) 
wump: the game of hunt-the-wumpus wump(6) 
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function, cosh: Fortran hyperbolic cosine intrinsic cosh(3F) 

sinh: hyperbolic functions sinh(3M) 

function, sinh: Fortran hyperbolic sine intrinsic sinh (3 F) 

function, tanh: Fortran hyperbolic tangent intrinsic tanh(3F) 

function, hypot: Euclidean distance hypot(3M) 

iargc iargc(3F) 

rje: RJE (Remote Job Entry) to IBM rjc(8) 

disk accounting data by user ID. diskusg: generate diskusg(lM) 

and names, id: print user and group IDs id ( 1 ) 

setpgrp: set process group ID setpgrp(2) 

issue: issue identification file issue (4) 

file or file/ fuser: identify processes using a fuser (1M) 

what: identify SCCS files what(l) 

id: print user and group IDs and names id ( 1 ) 

group, and parent process IDs. /get process, process getpid(2) 

getuid; get user IDs getuid(2) 

setgid: set user and group IDs. setuid, setuid(2) 

core: format of core image file core (4) 

convert a.out file to boot image, mkboot: mkboot(lM) 

crash: examine system images crash (1M) 

pnch: file format for card images pnch(4) 

argument, aimag: Fortran imaginary part of complex aimag(3F) 

nohup: run a command immune to hangups and quits nohup(l) 

fine: fast incremental backup finc(lM) 

of a/ ldtbindex: compute the index of a symbol table entry ldtbindex(3X) 

Fortran substring, index: return location of index(3F) 

a file, ldtbread: read an indexed symbol table entry of ldtbread(3X) 

of a file, ldshread: read an indexed/named section header .... ldshread(3X) 

object/ ldsseek: seek to an indexed/named section of an ldsseek(3X) 

initialization, init: process control init(lM) 

inittab: script for the init process inittab(4) 

init: process control initialization init(lM) 

bre: system initialization shell scripts brc(lM) 

information bdblk: print, initialize, update bad bdblk(lM) 

process, popen: initiate pipe to/from a popen(3S) 

process, inittab: script for the init inittab(4) 

clri: clear i-node clri(lM) 

inode: format of an i-node inode (4) 

inode: format of an i-node inode (4) 

scanf: convert formatted input scanf(3S) 

push character back into input stream, ungetc: ungetc(3S) 

fread: binary input/output fread(3S) 

stdio: standard buffered input/output package stdio(3S) 

ferror: stream status inquiries ferror(3S) 

uustat: uucp status inquiry and job control uustat(lC) 

install: install commands install (1M) 

install: install commands install (1M) 

directories, cpset: install object files in binary cpset(lM) 

conversion, int: explicit Fortran type ftype(3F) 

abs: return integer absolute value abs(3C) 

a641: convert between long integer and base-64 ASCII/ a641(3C) 

sputl: access long integer data in a/ sputl(3X) 

anint: Fortran nearest integer functions round(3F) 

function, aint: Fortran integer part intrinsic aint(3F) 

strtol: convert string to integer strtol(3C) 

13tol: convert between 3-byte integers and long integers 13tol(3C) 

3-byte integers and long integers, /convert between 13tol(3C) 

bcopy: interactive block copy bcopy(lM) 

system, mailx: interactive message processing .... mailx(l) 

acu: Automatic Call Unit (ACU) interface acu(7) 

du: DU-1 1 synchronous line interface du.pdp(7) 

err: error-logging interface err(7) 

ht: TUI 6/TE 16 magnetic tape interface ht(7) 

KL-1 1 or DL-1 1 asynchronous interface, kl: kl.pdp(7) 
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parallel communications link interface, pci: pci (7) 

plot: graphics interface plot (4) 

plot: graphics interface subroutines plot(3X) 

termio: general terminal interface termio(7) 

tm: TM1 1 /TUI 0 magnetic tape interface tm.pdp(7) 

ts: TS1 1 magnetic tape interface tsl 1 (7) 

tty: controlling terminal interface tty (7) 

tu78: TU78 magnetic tape interface tu78(7) 

VAX-1 1/780 LSI console floppy interface, vlx: vlx(lM) 

spline: interpolate smooth curve spline(lG) 

characters, asa: interpret ASA carriage control .... asa(l) 

sno: SNOBOL interpreter sno(l) 

pipe: create an interprocess channel pipe(2) 

facilities/ ipcs: report inter-process communication ipcs(l) 

package, ftok: standard interprocess communication stdipc(3C) 

suspend execution for an interval, sleep: sleep(l) 

sleep: suspend execution for interval sleep(3C) 

acos: Fortran arccosine intrinsic function acos(3F) 

aint: Fortran integer part intrinsic function aint(3F) 

asin: Fortran arcsine intrinsic function asin(3F) 

atan2: Fortran arctangent intrinsic function atan2(3F) 

atan: Fortran arctangent intrinsic function atan(3F) 

Fortran complex conjugate intrinsic function, conjg: conjg(3F) 

cos: Fortran cosine intrinsic function cos(3F) 

Fortran hyperbolic cosine intrinsic function, cosh: cosh(3F) 

double precision product intrinsic function, dprod: dprod(3F) 

exp: Fortran exponential intrinsic function exp(3F) 

Fortran common logarithm intrinsic function. loglO: logl0(3F) 

log: Fortran natural logarithm intrinsic function log (3 F) 

sign: Fortran transfer-of-sign intrinsic function sign(3F) 

sin: Fortran sine intrinsic function sin(3F) 

sinh: Fortran hyperbolic sine intrinsic function sinh(3F) 

sqrt: Fortran square root intrinsic function sqrt(3F) 

tan: Fortran tangent intrinsic function tan(3F) 

Fortran hyperbolic tangent intrinsic function, tanh: tanh(3F) 

dim: positive difference intrinsic functions dim(3F) 

mod: Fortran remaindering intrinsic functions mod(3F) 

lge: string comparision intrinsic functions strcmp(3F) 

commands intro: introduction to intro(l) 

formats, intro: introduction to file intro(4) 

intro: introduction to games intro(6) 

maintenance commands intro: introduction to intro(lM) 

miscellany, intro: introduction to intro(5) 

files, intro: introduction to special intro(7) 

subroutines and libraries, intro: introduction to intro(3) 

calls and error numbers, intro: introduction to system intro(2) 

maintenance procedures, intro: introduction to system intro(8) 

intro: introduction to commands intro(l) 

intro: introduction to file formats intro (4) 

intro: introduction to games intro(6) 

commands intro: introduction to maintenance intro(lM) 

intro: introduction to miscellany intro(5) 

intro: introduction to special files intro(7) 

and libraries, intro: introduction to subroutines intro(3) 

and error numbers, intro: introduction to system calls intro(2) 

maintenance/ intro: introduction to system intro(8) 

ncheck: generate names from i-numbers ncheck(lM) 

ioctl: control device ioctl (2) 

abort: generate an IOT fault aborl(3C) 

ipcrm: remove a message queue .... ipcrm(l) 

communication facilities/ ipcs: report inter-process ipcs(l) 

generator, irand: random number rand(3F) 

isalpha: classify characters ctype(3C) 

Fortran, system: issue a shell command from system(3F) 
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system: issue a shell command system (3S) 

issue: issue identification file issue(4) 

file, issue: issue identification issue (4) 

news: print news items news(l) 

functions. jO, jl, jn, yO, yl, yn: Bessel bessel(3M) 

functions. jO, jl, jn, yO, yl, yn: Bessel bessel(3M) 

bj: the game of black jack bj(6) 

functions. jO, jl, jn, yO, yl, yn: Bessel bessel(3M) 

operator, join: relational database join(l) 

jotto: secret word game jotto(6) 

for the K.MC1 IB kasb: assembler/un-assembler kasb(l) 

makekey: generate encryption key makekey(l) 

icillall: kill all active processes killall(lM) 

process or a group of/ kill: send a signal to a ki 11 (2) 

kill: terminate a process kill ( 1 ) 

processes, killall: kill all active killall(lM) 

asynchronous interface, kl: KL-1 1 or DL-1 1 kl.pdp(7) 

interface, kl: KL-1 1 or DL-1 1 asynchronous .... kl.pdp(7) 

microprocessor, kmc: KMC-1 1B/KMS1 1 kmc(7) 

vpmtest: test KMC lines vpmtest(lM) 

connect DM1 1 -BA modems to KMC11-B dmkset: dmkset(lM) 

assembler/un-assembler for the KMC11B kasb: kasb(l) 

microprocessor, kmc: KMC-1 1B/KMS1 1 kmc(7) 

quiz: test your knowledge quiz (6) 

integers and long integers. 13tol: convert between 3-byte 13tol(3C) 

copy file systems with label checking, volcopy: volcopy(lM) 

scanning and processing language, awk: pattern awk(l) 

arbitrary-precision arithmetic language, be: bc(l) 

efl: Extended Fortran Language efl(l) 

epp: the C language preprocessor cpp(l) 

command programming language, /standard/ restricted . . . . sh ( 1 ) 

shl: shell layer manager shl(l) 

object files. Id: link editor for common Id ( 1 ) 

Id: link editor ld.pdp(l) 

header ldahread: read the archive ldahread(3X) 

file, ldclose: close a common object .... ldclose(3X) 

access routines, ldfcn: common object file ldfcn(4) 

of a common object file, ldfhread: read the file header ldfhread(3X) 

name for file symbol table/ ldgetname: retrieve symbol ldgetname(3X) 

number entries of a file/ ldlread: manipulate line ldlread(3X) 

entries of a section of a/ ldlseek: seek to line number ldlseek(3X) 

file header of a file, ldohseek: seek to the optional ldohseek(3X) 

file for reading, ldopen: open a common object .... ldopen(3X) 

entries of a section of a/ ldrseek: seek to relocation ldrseek(3X) 

indexed/named section header/ ldshread: read an ldshread(3X) 

indexed/named section of an/ ldsseek: seek to an ldsseek(3X) 

of a symbol table entry of a/ ldtbindex: compute the index ldtbindex(3X) 

symbol table entry of a file, ldtbread: read an indexed ldtbread(3X) 

table of a common object/ ldtbseek: seek to the symbol ldtbseek(3X) 

string, len: return length of Fortran len(3F) 

len: return length of Fortran string len(3F) 

getopt: get option letter from argument vector getopt(3C) 

simple lexical tasks, lex: generate programs for lex(l) 

generate programs for simple lexical tasks, lex: lex(l) 

intrinsic functions, lge: string comparision strcmp(3F) 

to subroutines and libraries, /introduction intro(3) 

relation for an object library, /find ordering lorder(l) 

ar: archive and library maintainer ar.pdp(l) 

portable/ ar: archive and library maintainer for ar(l) 

ulimit: get and set user limits ulimit(2) 

an out-going terminal line connection, /establish dial (3C) 

type, modes, speed, and line discipline, /set terminal getty(lM) 

du: DU-1 1 synchronous line interface du.pdp(7) 

line: read one line lined ) 
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common object file, linenum: line number entries in a linenum(4) 

function, ldlread: manipulate line number entries of a file ldlread(3X) 

section of a/ ldlseek: seek to line number entries of a ldlseek(3X) 

file, strip: strip symbol and line number information from a . . . . strip(l) 

nl: line numbering filter nl(l) 

out selected fields of each line of a file, cut: cut cut(l) 

send/cancel requests to an LP line printer. Ip, cancel: lp(l) 

lp: line printer lp(7) 

line: read one line line(l) 

lsearch: linear search and update lsearch(3C) 

col: filter reverse line-feeds col(l) 

in a common object file, linenum: line number entries linenum (4) 

files, comm: select or reject lines common to two sorted comm(l) 

uniq: report repeated lines in a file uniq(l) 

paste: merge same lines of several file paste(l) 

vpmtest: test KMC lines vpmtest(lM) 

link: exercise link and unlink system calls link(lM) 

files. Id: link editor for common object Id ( 1 ) 

Id: link editor ld.pdp(l) 

a.out: common assembler and link editor output a.out(4) 

a.out: PDP-1 1 assembler and link editor output a.out. pdp(4) 

system calls, link: exercise link and unlink link(lM) 

pci: parallel communications link interface pci (7) 

link: link to a file Iink(2) 

pcldaemon: PCL link monitor pcldaemon(lM) 

cp, In, mv: copy, link or move files cp(l) 

link: link to a file link(2) 

protocol, dmc: communications link with built-in DDCMP dmc(7) 

lint: a C program checker lint ( 1 ) 

Is: list contents of directory ls(l) 

for a file system, flf: list file names and statistics ff(lM) 

nlist: get entries from name list nlist (3C) 

nm: print name list nm.pdp(l) 

nm: print name list of common object file nm(l) 

by fsck. checklist: list of file systems processed checklist (4) 

handle variable argument list, varargs: varargs(5) 

output of a varargs argument list, /print formatted vprintf(3S) 

output of a varargs argument list, /print formatted vprintf(3X) 

xargs: construct argument list(s) and execute command xargs(l) 

files, cp, In, mv: copy, link or move cp(l) 

romboot: special ROM bootstrap loaders romboot(8) 

index: return location of Fortran substring index(3F) 

end; last locations in program end(3C) 

memory, plock: lock process, text, or data in plock(2) 

intrinsic function, log: Fortran natural logarithm .... log(3F) 

gamma: log gamma function gamma(3M) 

newgrp: log in to a new group newgrp(l) 

logarithm intrinsic function, log 10: Fortran common logl0(3F) 

log 10: Fortran common logarithm intrinsic function log 1 0(3F) 

log: Fortran natural logarithm intrinsic function log(3F) 

functions, exp: exponential, logarithm, power, square root exp(3M) 

errpt: process a report of logged errors errpt(lM) 

getlogin: get login name getlogin(3C) 

logname: get login name logname(l) 

cuserid: get character login name of the user cuserid(3S) 

logname: return login name of user logname(3X) 

passwd: change login password passwd(l) 

login: sign on login (1) 

setting up an environment at login time, profile: profile(4) 

logname: get login name logname(l) 

user, logname: return login name of .... logname(3X) 

string. a641: convert between long integer and base-64 ASCII .... a641(3C) 

sputl: access long integer data in a/ sputl(3X) 

between 3-byte integers and long integers. 13tol: convert 13tol(3C) 
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for an object library, lorder: find ordering relation lorder(l) 

nice: run a command at low priority nice(l) 

requests to an LP line/ lp, cancel: send/cancel lp(l) 

send/cancel requests to an LP line printer, lp, cancel: lp(l) 

Ip: line printer lp(7) 

enable: enable/disable LP printers enabled) 

lpsched: start/stop the LP request scheduler lpsched(lM) 

accept: allow/prevent LP requests accept(lM) 

lpadmin: configure the LP spooling system lpadmin(lM) 

lpstat: print LP status information lpstat(l) 

spooling system, lpadmin: configure the LP lpadmin (1M) 

request scheduler lpsched: start/stop the LP lpsched(lM) 

information, lpstat: print LP status lpstat(l) 

directory. Is: list contents of ls(l) 

update, lsearch: linear search and lsearch(3C) 

pointer, lseek: move read/write file lseek(2) 

vlx: VAX-1 1/780 LSI console floppy interface vlx(lM) 

m4: macro processor m4(l) 

vpm: Virtual Protocol Machine vpm(7) 

for the virtual protocol machine, vpmc: compiler vpmc.dec(lM) 

values: machine-dependent values values(5) 

/access long integer data in a machine-independent fashion sputl(3X) 

m4: macro processor m4(l) 

program, tapeboot: magnetic tape bootstrap tapeboot(8) 

ht: TU16/TE16 magnetic tape interface ht(7) 

tm:TMll/TU10 magnetic tape interface tm.pdp(7) 

ts:TSll magnetic tape interface ts 1 1 (7) 

tu78: TU78 magnetic tape interface tu78(7) 

send mail to users or read mail, mail: mail(l) 

read mail, mail: send mail to users or mail(l) 

mail: send mail to users or read mail mail(l) 

processing system, mailx: interactive message mailx(l) 

malloc: main memory allocator malloc(3C) 

malloc: fast main memory allocator malloc(3X) 

regenerate groups of/ make: maintain, update, and make(l) 

ar: archive and library maintainer ar.pdp(l) 

ar: archive and library maintainer for portable/ ar(l) 

intro: introduction to maintenance commands intro(lM) 

intro: introduction to system maintenance procedures intro(8) 

SCCS file, delta: make a delta (change) to an delta(l) 

mkdir: make a directory mkdir(l) 

or ordinary file, mknod: make a directory, or a special mknod(2) 

mktemp: make a unique file name mktemp(3C) 

regenerate groups of/ make: maintain, update, and make(l) 

banner: make posters banner(l) 

key. makekey: generate encryption makekey(l) 

allocator, malloc: fast main memory malloc(3X) 

malloc: main memory allocator malloc(3C) 

manual, man: print entries in this man(l) 

tsearch: manage binary search trees tsearch(3C) 

hsearch: manage hash search tables hsearch(3C) 

shl: shell layer manager shl(l) 

records, fwtmp: manipulate connect accounting .... fwtmp(lM) 

of a file function, ldlread: manipulate line number entries .... ldlread(3X) 

floating-point/ frexp: manipulate parts of frexp(3C) 

man: print entries in this manual man(l) 

ascii: map of ASCII character set ascii (5) 

files, diffmk: mark differences between diffmk(l) 

umask: set file-creation mode mask umask(l) 

set and get file creation mask, umask: umask(2) 

table, master: master device information master.dec(4) 

information table, master: master device master. dec(4) 

regular expression compile and match routines, regexp: regexp(5) 

math: math functions and constants math(5) 
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constants, math: math functions and math(5) 

function, matherr: error-handling matherr(3M) 

multiple-access-user-space/ maus: maus(2) 

functions, max: Fortran maximum-value max(3F) 

max: Fortran maximum-value functions max(3F) 

maze: generate a maze maze(6) 

maze: generate a maze maze (6) 

accounting, mclock: return Fortran time mclock(3F) 

rp07: RP07 non-removable medium moving-head disk rp07(7) 

mem: core memory mem(7) 

memccpy: memory operations memory(3C) 

malloc: main memory allocator malloc(3C) 

malloc: fast main memory allocator malloc(3X) 

shmctl: shared memory control operations shmctl(2) 

mem: core memory mem(7) 

/(shared memory) operations maus(2) 

memccpy: memory operations memory(3C) 

shmop: shared memory operations shmop(2) 

lock process, text, or data in memory, plock: plock(2) 

shmget: get shared memory segment shmget(2) 

sort: sort and/or merge files sort(l) 

files, acctmerg: merge or add total accounting acctmerg(lM) 

file paste: merge same lines of several pasted) 

mesg: permit or deny messages mesg(l) 

msgctl: message control operations msgctl(2) 

msgop: message operations msgop(2) 

mailx: interactive message processing system mailx(l) 

ipcrm: remove a message queue ipcrm(l) 

msgget: get message queue msgget(2) 

mesg: permit or deny messages mesg(l) 

perror: system error messages perror(3C) 

kmc: KMC-1 1 B/KMS1 1 microprocessor kmc(7) 

functions, min: Fortran minimum-value min(3F) 

min: Fortran minimum-value functions min(3F) 

and commands, mk: how to remake the system .... mk(8) 

boot image, mkboot: convert a.out file to mkboot(lM) 

mkdir: make a directory mkdir(l) 

mkfs: construct a file system mkfs(lM) 

mknod: build special file mknod(lM) 

special or ordinary file, mknod: make a directory, or a .... mknod (2) 

name, mktemp: make a unique file mktemp(3C) 

mill: MLU solid-state disk mlll.pdp(7) 

mill: ML1 1 solid-state disk mlll.pdp(7) 

table, mnttab: mounted file system mnttab(4) 

intrinsic functions, mod: Fortran remaindering mod(3F) 

chmod: change mode chmod(l) 

umask: set file-creation mode mask umask(l) 

chmod: change mode of file chmod (2) 

dmk: DM11-BA modem control multiplexor dmk(7) 

dmkset: connect DM1 1 -BA modems to KMC 1 1-B dmkset(lM) 

getty: set terminal type, modes, speed, and line/ getty(lM) 

bs: a compiler/interpreter for modest-sized programs bs(l) 

touch: update access and modification times of a file touch (l) 

utime: set file access and modification times utime(2) 

pcldaemon: PCL link monitor pcldaemon(lM) 

profile, monitor: prepare execution monitor(3C) 

uusub: monitor uucp network uusub(lM) 

moo: guessing game moo (6) 

mount: mount a file system mount (2) 

system, mount: mount and dismount file mount(lM) 

mount: mount a file system mount (2) 

system, mount: mount and dismount file .... mount(lM) 

setmnt: establish mount table setmnt(lM) 

mnttab: mounted file system table mnttab (4) 
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mvdir: move a directory mvdir(lM) 

cp, In, mv: copy, link or move files cp(l) 

lseek: move read/write file pointer lseek(2) 

hm: RM05 moving-head disk hm(7) 

hp: RP04/RP05/RP06 moving-head disk hp(7) 

rm80: RM80 moving-head disk rm80(7) 

RP07 non-removable medium moving-head disk. rp07: rp07(7) 

rp: RP-1 1/RP03 moving-head disk rp.pdp(7) 

gd: general driver for moving-head disks gd(7) 

operations, msgctl: message control msgctl(2) 

msgget: get message queue msgget(2) 

msgop: message operations msgop(2) 

(shared memory)/ maus: multiple-access-user-space maus(2) 

DH-1 1 asynchronous multiplexers. /DZ-1 1/KMC-l IB, . . . dz(7) 

dmk: DM1 1 -BA modem control multiplexor dmk(7) 

cp, In, mv: copy, link or move files cp ( 1 ) 

mvdir: move a directory mvdir(lM) 

function, log: Fortran natural logarithm intrinsic log(3F) 

i-numbers. ncheck: generate names from ncheck(lM) 

anint: Fortran nearest integer functions round(3F) 

PCL network, net: execute a command on the .... net(lC) 

execute a command on the PCL network.net: net (1C) 

commands, stat: statistical network useful with graphical stat(lG) 

uusub: monitor uucp network uusub(lM) 

a text file, newform: change the format of .... newform(l) 

newgrp: log in to a new group newgrp(l) 

news: print news items news(l) 

news: print news items news(l) 

process, nice: change priority of a nice (2) 

priority, nice: run a command at low nice(l) 

nl: line numbering filter nl ( 1 ) 

list, nlist: get entries from name nlist(3C) 

nm: print name list nm.pdp(l) 

object file, nm: print name list of common .... nm(l) 

hangups and quits, nohup: run a command immune to . . . nohup(l) 

setjmp: non-local goto setjmp(3C) 

moving-head/ rp07: RP07 non-removable medium rp07(7) 

null: the null file null (7) 

null: the null file null (7) 

nl: line numbering filter nl (1 ) 

graphics: access graphical and numerical commands graphics(lG) 

ldfcn: common object file access routines ldfcn(4) 

dump selected parts of an object file, dump: dump(l) 

ldopen: open a common object file for reading ldopen(3X) 

ldclose: close a common object file ldclose(3X) 

the file header of a common object file, ldfhread: read ldfhread(3X) 

indexed/named section of an object file, /seek to an ldsseek(3X) 

the symbol table of a common object file, /seek to ldtbseek(3X) 

number entries in a common object file, linenum: line linenum(4) 

nm: print name list of common object file nm(l) 

information for a common object file, /relocation reloc(4) 

section header for a common object file, scnhdr: scnhdr(4) 

format, syms: common object file symbol table syms(4) 

filedieader for common object files, filehdr: filehdr(4) 

directories, cpset: install object files in binary cpset(lM) 

Id: link editor for common object files ld(l) 

print section sizes of common object files, size: size(l) 

size: print sizes of object files size.pdp(l) 

find ordering relation for an object library, lorder: lorder(l) 

formats, convert: convert object/archive files to common .... convert (1) 

sky: obtain ephemerides sky (6) 

od: octal dump. od(l) 

od: octal dump od(l) 

reading, ldopen: open a common object file for ldopen(3X) 


- 25 - 



Permuted Index 


fopen: open a stream fopen(3S) 

dup: duplicate an open file descriptor dup(2) 

open: open for reading or writing open(2) 

writing, open: open for reading or open(2) 

prf: operating system profiler prf (7) 

prfld: operating system profiler profiler(lM) 

750ops: VAX-1 1/750 console operations 750ops(8) 

780ops: VAX-1 1/780 console operations 780ops(8) 

/(shared memory) operations maus(2) 

memccpy: memory operations memory (3C) 

msgctl: message control operations msgctl(2) 

msgop: message operations msgop(2) 

semctl: semaphore control operations semctl(2) 

semop: semaphore operations semop(2) 

shmctl: shared memory control operations shmctl(2) 

shmop: shared memory operations shmop(2) 

strcat: string operations string(3C) 

join: relational database operator join(l) 

dcopy: copy file systems for optimal access time dcopy(lM) 

CRT screen handling and optimization package, curses: curses (3X) 

vector, getopt: get option letter from argument getopt(3C) 

file, ldohseek: seek to the optional file header of a ldohseek(3X) 

fcntl: file control options fcntl (5) 

stty: set the options for a terminal stty(l) 

getopt: parse command options getopt (1) 

functions, and, or, xor, not: Fortran boolean bool(3F) 

object library, lorder: find ordering relation for an lorder(l) 

a directory, or a special or ordinary file, mknod: make mknod(2) 

dial: establish an out-going terminal line/ dial (3C) 

assembler and link editor output, a.out: common a.out(4) 

assembler and link editor output, a.out: PDP-1 1 a.out.pdp(4) 

vprintf: print formatted output of a varargs argument/ .... vprintf(3S) 

vprintf: print formatted output of a varargs argument/ .... vprintf(3X) 

printf: print formatted output printf(3S) 

acctdisk: overview of accounting acct(lM) 

chown: change owner and group of a file chown(2) 

chown: change owner or group chown(l) 

files, pack: compress and expand pack(l) 

handling and optimization package, curses: CRT screen curses (3X) 

sa 1 : system activity report package sar(lM) 

standard buffered input/output package, stdio: stdio(3S) 

interprocess communication package, ftok: standard stdipc(3C) 

check RP06 and RM05 disk packs, format: format and/or format(lM) 

4014 terminal. 4014: paginator for the TEKTRONIX . . . 4014(1) 

interface, pci: parallel communications link pci (7) 

process, process group, and parent process IDs. /get getpid(2) 

getopt: parse command options getopt(l) 

passwd: change login password passwd(l) 

passwd: password file passwd (4) 

getpwent: get password file entry getpwent(3C) 

putpwent: write password file entry putpwent(3C) 

passwd: password file passwd (4) 

getpass: read a password getpass(3C) 

passwd: change login password passwd(l) 

pwck: password/group file checkers pwck(lM) 

several file paste: merge same lines of paste(l) 

dirname: deliver portions of path names, basename, basename(l) 

directory, getcwd: get path-name of current working getcwd(3C) 

grep: search a file for a pattern grep(l) 

processing language, awk: pattern scanning and awk(l) 

signal, pause: suspend process until pause (2) 

pcldaemon: PCL link monitor pcldaemon(lM) 

net: execute a command on the PCL network net (1C) 

link interface, pci: parallel communications pcl(7) 
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fscv: convert files between 
as: assembler for 
editor output, a.out: 
/convert archive files from 
value about processor type. 

mesg: 
format, acct: 
acctcms: command summary from 

terminals, pg: file 
soft-copy terminals, 
split: split a file into 
channel, 
tee: 

popen: initiate 
data in memory. 

subroutines, 
images, 
fseek: reposition a file 
lseek: move read/write file 
process. 

and library maintainer for 
basename, dirname: deliver 
functions, dim: 
banner: make 
exp: exponential, logarithm, 

function, dprod: double 
monitor: 
cpp: the C language 
unget: undo a 
profiler, 
profiler. 

graphical/ gps: graphical 
types: 

prs: 

date: 

cal: 

of a file, sum: 
editing activity, sact: 

man: 

cat: concatenate and 
pr: 

varargs argument/ vprintf: 
varargs argument/ vprintf: 

printf: 

information bdblk: 

lpstat: 

nm: 

object file, nm: 
system, uname: 

news: 

file(s). acctcom: search and 
object files, size: 

size: 
names, id: 
vpmsave: save and 
requests to an LP line 
lp: line 
vpr: Versatec 
vp: Versatec 
enable: enable/disable LP 


pcldaemon: PCL link monitor pcldaemon(lM) 

PDP-1 1 and VAX-1 1/780 systems. . . fscv.vax(lM) 

PDP-11 as.pdp(l) 

PDP-1 1 assembler and link a.out. pdp(4) 

PDP-11 to common format arcv.pdp(l) 

pdpl 1, vax: provide truth machid(l) 

permit or deny messages mesg(l) 

per-process accounting file acct (4) 

per-process accounting/ acctcms(lM) 

perror: system error messages perror(3C) 


perusal filter for soft-copy pgd) 

pg: file perusal filter for pg(l) 

pieces split (1) 

pipe: create an interprocess pipe(2) 


pipe fitting tee(l) 

pipe to/from a process popen(3S) 

plock: lock process, text, or plock(2) 

plot: graphics interface plot (4) 


plot: graphics interface plot(3X) 

pnch: file format for card pnch(4) 

pointer in a stream fseek(3S) 

pointer. lseek(2) 

popen: initiate pipe to/from a popen (3S) 

portable archives, /archive ar(l) 

portions of path names basename(l) 

positive difference intrinsic dim(3F) 

posters banner (1) 

power, square root functions exp(3M) 

pr: print files pr(l) 

precision product intrinsic dprod(3F) 

prepare execution profile monitor (3C) 

preprocessor cpp(l) 

previous get of an SCCS file unget(l) 

prf: operating system prf(7) 

prfld: operating system profiler(lM) 


primitive string, format of gps (4) 

primitive system data types types(5) 

print an SCCS file prs(l) 


print and set the date date(l) 

print calendar cal(l) 

print checksum and block count .... sum(l) 

print current SCCS file sact(l) 

print entries in this manual man(l) 

print files cat(l) 


print files 

print formatted output of a 
print formatted output of a 
print formatted output, 
print, initialize, update bad 
print LP status information. 

print name list 

print name list of common 
print name of current UNIX 

print news items 

print process accounting 
print section sizes of common 
print sizes of object files. . 
print user and group IDs and 
print VPM event traces, 
printer, /cancel: send/cancel 

printer 

printer spooler 

printer 

printers 


pr (1) 

vprintf(3S) 

vprintf(3X) 

printf(3S) 

bdblk (1M) 

lpstat(l) 

nm.pdp(l) 

nm(l) 

uname(l) 

news(l) 

acctcom(l) 

size(l) 

size.pdp(l) 

id(l) 

vpmsave(lM) 

lp(l) 

lp(7) 

vpr(l) 

vp.pdp(7) 

enabled) 
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output, printf: print formatted printf(3S) 

nice: run a command at low priority nice(l) 

nice: change priority of a process nice(2) 

errors, errpt: process a report of logged errpt(lM) 

acct: enable or disable process accounting acct(2) 

acctprcl: process accounting acctprc(lM) 

acctcom: search and print process accounting file(s) acctcom(l) 

alarm: set a process alarm clock alarm (2) 

times, times: get process and child process times (2) 

initialization, init: process control init(lM) 

timex: time a command; report process data and system/ timex(l) 

exit: terminate process exit(2) 

fork: create a new process fork(2) 

process/ getpid: get process, process group, and parent getpid(2) 

setpgrp: set process group ID setpgrp(2) 

process group, and parent process IDs. /get process, getpid(2) 

inittab: script for the init process inittab(4) 

kill: terminate a process kill(l) 

nice: change priority of a process nice (2) 

kill: send a signal to a process or a group of/ kill (2) 

popen; initiate pipe to/from a process popen(3S) 

parent process/ getpid: get process, process group, and getpid (2) 

ps: report process status ps(l) 

memory, plock: lock process, text, or data in plock(2) 

times: get process and child process times times(2) 

wait: wait for child process to stop or terminate wait(2) 

ptrace: process trace ptrace(2) 

pause: suspend process until signal pause(2) 

wait: await completion of process wait(l) 

list of file systems processed by fsck. checklist: checklist (4) 

to a process or a group of processes, /send a signal kill (2) 

killall: kill all active processes killall(lM) 

structure, fuser: identify processes using a file or file fuser(lM) 

awk: pattern scanning and processing language awk(l) 

shutdown: terminate all processing shutdown (1M) 

mailx: interactive message processing system mailx(l) 

m4: macro processor m4(l) 

vax: provide truth value about processor type, pdp 1 1 machid(l) 

dprod: double precision product intrinsic function dprod(3F) 

prof: display profile data prof(l) 

function, prof: profile within a prof(5) 

profile, profit : execution time profil(2) 

prof: display profile data prof(l) 

monitor: prepare execution profile monitor(3C) 

profil: execution time profile profil(2) 

environment at login time, profile: setting up an profile (4) 

prof: profile within a function prof(5) 

prf: operating system profiler prf(7) 

prfld: operating system profiler profiler(lM) 

sadp: disk access profiler sadp(lM) 

standard/restricted command programming language, /the sh ( 1 ) 

link with built-in DDCMP protocol, dmc: communications .... dmc(7) 

vpm: Virtual Protocol Machine vpm(7) 

vpmc: compiler for the virtual protocol machine vpmc.dec(lM) 

arithmetic: provide drill in number facts arithmetic(6) 

processor type, pdpll, vax: provide truth value about machid(l) 

true: provide truth values true(l) 

prs: print an SCCS file prs(l) 

ps: report process status ps(l) 

sxt: pseudo-device driver sxt(7) 

/generate uniformly distributed pseudo-random numbers drand48(3C) 

ptrace: process trace ptrace (2) 

stream, ungetc: push character back into input .... ungetc(3S) 

a stream, putc: put character or word on .... putc(3S) 
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environment, putenv: change or add value to .... putenv(3C) 

entry, putpwent: write password file putpwent(3C) 

stream, puts: put a string on a puts(3S) 

checkers, pwck: password/group file pwck(lM) 

pwd: working directory name pwd(l) 

Survey, qasurvey: Quality Assurance qasurvey(lM) 

qsort: quicker sort qsort(3C) 

qasurvey: Quality Assurance Survey qasurvey(lM) 

tput: query terminfo database tput(l) 

ipcrm: remove a message queue ipcrm(l) 

msgget: get message queue msgget(2) 

qsort: quicker sort qsort (3C) 

command immune to hangups and quits, nohup: run a nohup(l) 

quiz: test your knowledge quiz(6) 

generator, rand: simple random-number rand(3C) 

irand: random number generator rand(3F) 

rand: simple random-number generator rand(3C) 

fsplit: split f77, ratfor, or efl files fsplit(l) 

dialect, ratfor: rational Fortran ratfor(l) 

ratfor: rational Fortran dialect ratfor(l) 

getpass: read a password getpass(3C) 

entry of a file, ldtbread: read an indexed symbol table ldtbread(3X) 

header of a file, ldshread: read an indexed/named section .... ldshread(3X) 

read: read from file read (2) 

mail: send mail to users or read mail mail(l) 

line: read one line line(l) 

read: read from file. read (2) 

ldahread: read the archive header ldahread(3X) 

common object file, ldfhread: read the file header of a ldfhread(3X) 

open a common object file for reading, ldopen: ldopen(3X) 

open: open for reading or writing open(2) 

lseek: move read/write file pointer lseek(2) 

specify what to do upon receipt of a signal, signal: signal (2) 

/specify Fortran action on receipt of a system signal signal(3F) 

from per-process accounting records, /command summary acctcms(lM) 

errdead: extract error records from dump errdead(lM) 

manipulate connect accounting records, fwtmp: fwtmp(lM) 

tape, free: recover files from a backup freed M) 

ed, red: text editor ed(l) 

regular expression, regemp: compile and execute regcmp(3X) 

compile, regemp: regular expression regcmp(l) 

make: maintain, update, and regenerate groups of programs make(l) 

compile and match routines, regexp: regular expression regexp (5) 

match routines, regexp: regular expression compile and .... regexp(5) 

regemp: regular expression compile regcmp(l) 

regemp: compile and execute regular expression regcmp(3X) 

sorted files, comm: select or reject lines common to two comm(l) 

lorder: find ordering relation for an object/ lorder(l) 

join: relational database operator join(l) 

for a common object file, reloc: relocation information reloc(4) 

strip: remove symbols and relocation bits strip.pdp(l) 

section of a/ ldrseek: seek to relocation entries of a ldrseek(3X) 

common object file, reloc: relocation information for a reloc (4) 

floor: floor, ceiling, remainder, absolute value/ floor(3M) 

functions, mod: Fortran remaindering intrinsic mod(3F) 

commands, mk: how to remake the system and mk(8) 

calendar: reminder service calendar(l) 

rje: RJE (Remote Job Entry) to IBM rje(8) 

ct: spawn getty to a remote terminal ct(lC) 

file, rmdel: remove a delta from an SCCS .... rmdel(l) 

ipcrm: remove a message queue ipcrm(l) 

unlink: remove directory entry unlink(2) 

rm: remove files or directories rm(l) 

bits, strip: remove symbols and relocation .... strip. pdp(l) 
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uniq: report repeated lines in a file uniq(l) 

clock: report CPU time used clock(3C) 

communication/ ipcs: report inter-process ipcs(l) 

blocks, df: report number of free disk df(lM) 

errpt: process a report of logged errors errpt(lM) 

sal: system activity report package sar(lM) 

timex: time a command; report process data and system/ .... timex(l) 

ps: report process status ps(l) 

file, uniq: report repeated lines in a uniq(l) 

rjestat: RJE status report rjestat(lC) 

trenter: enter a trouble report trenter(l) 

sar: system activity reporter sar(l) 

stream, fseek: reposition a file pointer in a fseek(3S) 

lpsched: start/stop the LP request scheduler lpsched(lM) 

accept: allow/prevent LP requests accept(lM) 

lp, cancel: send/cancel requests to an LP line/ lp(l) 

symbol table/ ldgetname: retrieve symbol name for file ldgetname(3X) 

argument, getarg: return Fortran command-line getarg(3F) 

variable, getenv: return Fortran environment getenv(3F) 

accounting, mclock: return Fortran time mclock(3F) 

abs: return integer absolute value abs(3C) 

string, len: return length of Fortran len(3F) 

substring, index: return location of Fortran index(3F) 

lognamcr return login name of user logname(3X) 

name, getenv: return value for environment getenv (3C) 

stat: data returned by stat system call stat(5) 

reversi: a game of dramatic reversals reversi(6) 

col: filter reverse line-feeds col(l) 

reversals, reversi: a game of dramatic reversi (6) 

creat: create a new file or rewrite an existing one creat(2) 

file, rf: RF1 1/RSI 1 fixed-head disk .... rf.pdp(7) 

file, rf: RF11/RS11 fixed-head disk rf.pdp(7) 

disk file, hs: RH1 1/RJS03-RJS04 fixed-head . . . hs.pdp(7) 

gather files and/or submit RJE jobs, send: send (1C) 

rje: RJE (Remote Job Entry) to IBM. . . . rje(8) 

IBM. rje: RJE (Remote Job Entry) to ... . rje(8) 

rjestat: RJE status report rjestat(lC) 

rjestat: RJE status report rjestat(lC) 

rk: RK-1 1/RK03 or RK05 disk rk.pdp(7) 

rk: RK-1 1/RK03 or RK05 disk rk.pdp(7) 

rk: RK-1 1/RK03 or RK05 disk rk.pdp(7) 

rl: RL-11/RL01 disk rl(7) 

rl: RL-1 1/RL01 disk rl(7) 

directories, rm: remove files or rm(l) 

format and/or check RP06 and RM05 disk packs, format: format (1M) 

hm: RM05 moving-head disk hm(7) 

rm80: RM80 moving-head disk rm80(7) 

rm80: RM80 moving-head disk rm80(7) 

SCCS file, rmdel: remove a delta from an .... rmdel(l) 

romboot: special ROM bootstrap loaders romboot(8) 

loaders, romboot: special ROM bootstrap . . . romboot (8) 

chroot: change root directory chroot(2) 

chroot: change root directory for a command chroot(lM) 

logarithm, power, square root functions, /exponential exp(3M) 

sqrt: Fortran square root intrinsic function sqrt(3F) 

hpd: graphical device routines and filters gdev(lG) 

common object file access routines, ldfcn: ldfcn(4) 

expression compile and match routines, regexp: regular regexp(5) 

graphical table of contents routines, toe: toc(lG) 

disk, rp: RP-1 1/RP03 moving-head .... rp.pdp(7) 

moving-head disk, hp: RP04/RP05/RP06 hp(7) 

format: format and/or check RP06 and RM05 disk packs format(lM) 

moving-head disk. rp07: RP07 non-removable medium rp07(7) 

medium moving-head disk. rp07: RP07 non-removable rp07(7) 
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rp: RP-1 1/RP03 moving-head disk rp.pdp(7) 

nice: run a command at low priority nice(l) 

hangups and quits, nohup: run a command immune to nohup(l) 

runacct: run daily accounting runacct(lM) 

runacct: run daily accounting runacct (1M) 

package, sal: system activity report sar(lM) 

editing activity, sact: print current SCCS file sact(l) 

sadp: disk access profiler sadp(lM) 

sag: system activity graph sag(lG) 

sar: system activity reporter sar(l) 

traces, vpmsave: save and print VPM event vpmsave(lM) 

input, scanf: convert formatted scanf(3S) 

bfs: big file scanner bfs(l) 

language, awk: pattern scanning and processing awk(l) 

stand-alone programs, see: C compiler for scc(l) 

the delta commentary of an SCCS delta, ede: change cdc(l) 

comb: combine SCCS deltas comb(l) 

make a delta (change) to an SCCS file, delta: delta (l) 

sact: print current SCCS file editing activity sact(l) 

get: get a version of an SCCS file get(l) 

prs: print an SCCS file prs(l) 

rmdel: remove a delta from an SCCS file rmdel(l) 

compare two versions of an SCCS file, sccsdiff: sccsdiflf(l) 

sccsfile: format of SCCS file sccsfile(4) 

undo a previous get of an SCCS file, unget: unget(l) 

val: validate SCCS file val(l) 

admin: create and administer SCCS files admin(l) 

what: identify SCCS files what(l) 

of an SCCS file, sccsdiff: compare two versions sccsdiff(l) 

sccsfile: format of SCCS file sccsfile (4) 

start/stop the LP request scheduler lpsched: lpsched(lM) 

common object file, scnhdr: section header for a scnhdr(4) 

optimization/ curses: CRT screen handling and curses(3X) 

vi: screen-oriented editor vi ( 1 ) 

inittab: script for the init process inittab(4) 

system initialization shell scripts, bre: brc(lM) 

sdb: symbolic debugger sdb(l) 

program. sdifT: side-by-side difference sdifT(l) 

grep: search a file for a pattern grep(l) 

bsearch: binary search a sorted table bsearch(3C) 

accounting file(s). acctcom: search and print process acctcom(l) 

lsearch: linear search and update lsearch(3C) 

hsearch: manage hash search tables hsearch(3C) 

tsearch: manage binary search trees tsearch(3C) 

jotto: secret word game jotto(6) 

object file, scnhdr: section header for a common ..... scnhdr (4) 

/read an indexed/named section header of a file ldshread(3X) 

to line number entries of a section of a file, /seek ldlseek(3X) 

to relocation entries of a section of a file, /seek ldrseek(3X) 

/seek to an indexed/named section of an object file ldsseek(3X) 

files, size: print section sizes of common object .... size(l) 

sed: stream editor sed(l) 

section of an object/ ldsseek: seek to an indexed/named ldsseek(3X) 

a section of a file, ldlseek: seek to line number entries of ldlseek(3X) 

a section of a file, ldrseek: seek to relocation entries of ldrseek(3X) 

header of a file, ldohseek: seek to the optional file ldohseek(3X) 

common object file, ldtbseek: seek to the symbol table of a ldtbseek(3X) 

shmget: get shared memory segment shmget(2) 

brk: change data segment space allocation brk(2) 

to two sorted files, comm: select or reject lines common comm(l) 

greek: select terminal filter greek(l) 

of a file, cut: cut out selected fields of each line cut(l) 

file, dump: dump selected parts of an object dump(l) 

semctl: semaphore control operations semctl(2) 
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semop: semaphore operations semop(2) 

semget: get set of semaphores semget(2) 

operations, semctl: semaphore control semctl(2) 

semget: get set of semaphores semget(2) 

semop: semaphore operations semop (2) 

a group of processes, kill: send a signal to a process or kill (2) 

submit RJE jobs, send: gather files and/or send (1C) 

mail, mail: send mail to users or read mail(l) 

line printer. Ip, cancel: send/cancel requests to an LP lp(l) 

stream, setbuf: assign buffering to a setbuf(3S) 

IDs. setuid, setgid: set user and group setuid(2) 

setjmp: non-local goto setjmp(3C) 

setmnt: establish mount table setmnt(lM) 

setpgrp: set process group ID setpgrp(2) 

login time, profile: setting up an environment at profile (4) 

gettydefs: speed and terminal settings used by getty gettydefs(4) 

group IDs. setuid, setgid: set user and setuid (2) 

standard/restricted command/ sh: shell, the sh(l) 

operations, shmctl: shared memory control shmctl(2) 

/multiple-access-user-space (shared memory) operations maus(2) 

shmop: shared memory operations shmop(2) 

shmget: get shared memory segment shmget(2) 

system: issue a shell command from Fortran system (3 F) 

system: issue a shell command system (3S) 

shl: shell layer manager shKl) 

accounting, chargefee: shell procedures for acctsh(lM) 

brc: system initialization shell scripts brc(lM) 

command programming/ sh: shell, the standard/restricted shCl) 

shl: shell layer manager shl ( 1 ) 

operations, shmctl: shared memory control .... shmctl (2) 

segment, shmget: get shared memory shmget(2) 

operations, shmop: shared memory shmop (2) 

processing, shutdown: terminate all shutdown (1M) 

program, sdiff: side-by-side difference sdiff(l) 

intrinsic function, sign: Fortran transfer-of-sign sign(3F) 

login: sign on login(l) 

pause: suspend process until signal pause(2) 

what to do upon receipt of a signal, signal: specify signal(2) 

action on receipt of a system signal, /specify Fortran signal(3F) 

on receipt of a system/ signal: specify Fortran action signal (3 F) 

upon receipt of a signal, signal: specify what to do signal (2) 

of processes, kill: send a signal to a process or a group kill (2) 

ssignal: software signals ssignal (3C) 

lex: generate programs for simple lexical tasks lex(l) 

generator, rand: simple random-number rand(3C) 

function, sin: Fortran sine intrinsic sin(3F) 

sin: trigonometric functions trig(3M) 

sin: Fortran sine intrinsic function sin(3F) 

sinh: Fortran hyperbolic sine intrinsic function sinh(3F) 

intrinsic function, sinh: Fortran hyperbolic sine sinh(3F) 

sinh: hyperbolic functions sinh(3M) 

common object files, size: print section sizes of size(l) 

files, size: print sizes of object size.pdp(l) 

size: print section sizes of common object files size(l) 

size: print sizes of object files size.pdp(l) 

sky: obtain ephemerides sky (6) 

an interval, sleep: suspend execution for sleep(l) 

interval, sleep: suspend execution for sleep(3C) 

current/ ttyslot: find the slot in the utmp file of the ttyslot(3C) 

spline: interpolate smooth curve spline (1G) 

sno: SNOBOL interpreter sno(l) 

sno: SNOBOL interpreter sno(l) 

pg: file perusal filter for soft-copy terminals Pg(l) 

ssignal: software signals ssignal (3C) 
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mlll:MLll solid-state disk mlll.pdp(7) 

sort: sort and/or merge files sort(l) 

qsort: quicker sort qsort(3C) 

sort: sort and/or merge files sort(l) 

tsort: topological sort tsort(l) 

or reject lines common to two sorted files, comm: select comm(l) 

bsearch: binary search a sorted table bsearch(3C) 

brk: change data segment space allocation brk(2) 

terminal, ct: spawn getty to a remote ct(lC) 

fspec: format specification in text files fspec(4) 

receipt of a system/ signal: specify Fortran action on signal(3F) 

receipt of a signal, signal: specify what to do upon signal (2) 

/set terminal type, modes, speed, and line discipline getty (1M) 

used by getty. gettydefs: speed and terminal settings gettydefs(4) 

spell: find spelling errors spell (1) 

spell: find spelling errors spell(l) 

curve, spline: interpolate smooth spline(lG) 

split: split a file into pieces split(l) 

csplit: context split csplit(l) 

files, fsplit: split f77, ratfor, or efl fsplit(l) 

pieces, split: split a file into split(l) 

uuclean: uucp spool directory clean-up uuclean(lM) 

vpr: Versa tec printer spooler vpr(l) 

lpadmin: configure the LP spooling system Ipadmin(lM) 

data in a machine-independent/ sputl: access long integer sputl(3X) 

intrinsic function, sqrt: Fortran square root sqrt(3F) 

exponential, logarithm, power, square root functions, exp: exp(3M) 

function, sqrt: Fortran square root intrinsic sqrt(3F) 

ssignal: software signals ssignal(3C) 

see: C compiler for stand-alone programs scc(l) 

package, stdio: standard buffered input/output .... stdio(3S) 

communication package, ftok: standard interprocess stdipc(3C) 

programming/ sh: shell, the standard/restricted command sh(l) 

scheduler lpsched: start/stop the LP request lpsched(lM) 

unixboot: UNIX system startup and boot procedures unixboot(8) 

system call, stat: data returned by stat stat(5) 

stat: get file status stat(2) 

useful with graphical/ stat: statistical network stat(lG) 

stat: data returned by stat system call stat (5) 

with graphical/ stat: statistical network useful stat(lG) 

ff: list file names and statistics for a file system ff(lM) 

ustat: get file system statistics ustat(2) 

lpstat: print LP status information lpstat(l) 

ferror: stream status inquiries ferror(3S) 

control, uustat: uucp status inquiry and job uustat(lC) 

communication facilities status, /report inter-process ipcs(l) 

ps: report process status ps(l) 

rjestat: RJE status report rjestat(lC) 

stat: get file status stat (2) 

input/output package, stdio: standard buffered stdio(3S) 

stime: set time stime(2) 

wait for child process to stop or terminate, wait: wait (2) 

streat: string operations string (3C) 

sed: stream editor sed(l) 

fclose: close or flush a stream fclose(3S) 

fopen: open a stream fopen(3S) 

reposition a file pointer in a stream, fseek: fseek(3S) 

get character or word from a stream, getc: getc(3S) 

gets: get a string from a stream gets(3S) 

put character or word on a stream, putc: putc(3S) 

puts: put a string on a stream puts(3S) 

setbuf: assign buffering to a stream setbuf(3S) 

ferror: stream status inquiries ferror(3S) 

push character back into input stream, ungetc: ungetc(3S) 
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long integer and base-64 ASCII string. a641: convert between a641(3C) 

functions, lge: string comparision intrinsic strcmp(3F) 

convert date and time to string, dime: ctime(3C) 

floating-point number to string, ecvt: convert ecvt(3C) 

gps: graphical primitive string, format of graphical/ gps(4) 

gets: get a string from a stream gets(3S) 

len: return length of Fortran string len(3F) 

puts: put a string on a stream puts(3S) 

strcat: string operations string(3C) 

number, strtod: convert string to double-precision strtod (3C) 

strtol: convert string to integer strtol(3C) 

relocation bits, strip: remove symbols and strip.pdp(l) 

number information from a/ strip: strip symbol and line strip(l) 

information from a/ strip: strip symbol and line number strip(l) 

double-precision number, strtod: convert string to strtod (3C) 

integer, strtol: convert string to strtol(3C) 

processes using a file or file structure, fuser: identify fuser(lM) 

terminal, stty: set the options for a stty(l) 

another user, su: become super-user or su(l) 

send: gather files and/or submit RJE jobs send(lC) 

intro: introduction to subroutines and libraries intro(3) 

plot: graphics interface subroutines plot(3X) 

return location of Fortran substring, index: index(3F) 

count of a file, sum: print checksum and block .... sum(l) 

du: summarize disk usage du(l) 

accounting/ acctcms: command summary from per-process acctcms(lM) 

sync: update the super block sync(l) 

sync: update super-block sync(2) 

su: become super-user or another user su (1 ) 

qasurvey: Quality Assurance Survey qasurvey(lM) 

interval, sleep: suspend execution for an sleep(l) 

interval, sleep: suspend execution for sleep(3C) 

pause: suspend process until signal pause(2) 

swab: swap bytes swab(3C) 

swab: swap bytes swab(3C) 

sxt: pseudo-device driver sxt(7) 

information from/ strip: strip symbol and line number strip(l) 

table/ ldgetname: retrieve symbol name for file symbol ldgetname(3X) 

/retrieve symbol name for file symbol table entry ldgetname(3X) 

/compute the index of a symbol table entry of a file ldtbindex(3X) 

ldtbread: read an indexed symbol table entry of a file ldtbread(3X) 

syms: common object file symbol table format syms(4) 

object/ ldtbseek: seek to the symbol table of a common ldtbseek(3X) 

sdb: symbolic debugger sdb(l) 

strip: remove symbols and relocation bits strip. pdp(l) 

symbol table format, syms: common object file syms (4) 

sync: update super-block sync (2) 

sync: update the super block sync(l) 

du: DU-11 synchronous line interface du.pdp(7) 

sysdef: system definition sysdef(lM) 

binary search a sorted table, bsearch: bsearch(3C) 

symbol name for file symbol table entry, /retrieve ldgetname(3X) 

/compute the index of a symbol table entry of a file ldtbindex(3X) 

/read an indexed symbol table entry of a file ldtbread (3X) 

common object file symbol table format, syms: syms(4) 

master device information table, master: master.dec(4) 

mnttab: mounted file system table mnttab(4) 

ldtbseek: seek to the symbol table of a common object file ldtbseek (3X) 

toe: graphical table of contents routines toc(lG) 

setmnt: establish mount table setmnt(lM) 

hsearch: manage hash search tables hsearch(3C) 

tabs: set tabs on a terminal tabs(l) 

tabs: set tabs on a terminal tabs(l) 

a file, tail: deliver the last part of tail(l) 
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function, tan: Fortran tangent intrinsic tan(3F) 

tan: Fortran tangent intrinsic function tan(3F) 

tanh: Fortran hyperbolic tangent intrinsic function tanh(3F) 

tangent intrinsic function, tanh: Fortran hyperbolic tanh(3F) 

tapeboot: magnetic tape bootstrap program tapeboot(8) 

gt: general driver for tape drives gt(7) 

hpio: HP 2645 A terminal tape file archiver hpio(l) 

tar: tape file archiver tar(l) 

recover files from a backup tape, free: frec(lM) 

ht: TU16/TE16 magnetic tape interface ht(7) 

tm: TM 11 /TUI 0 magnetic tape interface tm.pdp(7) 

ts: TS 11 magnetic tape interface tsl 1 (7) 

tu78: TU78 magnetic tape interface tu78(7) 

bootstrap program, tapeboot: magnetic tape tapeboot (8) 

tar: tape file archiver tar(l) 

programs for simple lexical tasks, lex: generate lex(l) 

tee: pipe fitting tee(l) 

4014: paginator for the TEKTRONIX 4014 terminal 4014(1) 

tmpfile: create a temporary file tmpfile(3S) 

tmpnam: create a name for a temporary file tmpnam(3S) 

terminals, term: conventional names for term (5) 

term: format of compiled term file term (4) 

file., term: format of compiled term .... term(4) 

for the TEKTRONIX 4014 terminal. 4014: paginator 4014(1) 

functions of the DASI 450 terminal. 450: handle special 450(1) 

terminfo: terminal capability data base terminfo(4) 

ct: spawn getty to a remote terminal ct(lC) 

generate file name for terminal, ctermid: ctermid(3S) 

greek: select terminal filter greek(l) 

termio: general terminal interface termio(7) 

tty: controlling terminal interface tty (7) 

dial: establish an out-going terminal line connection dial(3C) 

getty. gettydefs: speed and terminal settings used by gettydefs(4) 

stty: set the options for a terminal stty(l) 

tabs: set tabs on a terminal tabs(l) 

hpio: HP 2645A terminal tape file archiver hpio(l) 

tty: get the name of the terminal tty(l) 

ttyname: find name of a terminal ttyname(3C) 

and line/ getty: set terminal type, modes, speed, getty (1M) 

300: DASI 300 and 300s terminals 300(1) 

handle special functions of HP terminals, hp: hp(U 

perusal filter for soft-copy terminals, pg: file 

term: conventional names for terminals term (5) 

kill: terminate a process kill ( 1) 

shutdown: terminate all processing shutdown (1M) 

abort: terminate Fortran program abort(3F) 

exit: terminate process exit (2) 

daemon, errstop: terminate the error-logging errstop(lM) 

for child process to stop or terminate, wait: wait wait (2) 

tic: terminfo compiler tic(lM) 

tput: query terminfo database tput(l) 

data base, terminfo: terminal capability terminfo(4) 

interface, termio: general terminal termio (7) 

command, test: condition evaluation test(l) 

vpmtest: test KMC lines vpmtest(lM) 

quiz: test your knowledge quiz(6) 

ed, red: text editor ed(l) 

edit: text editor edit(l) 

ex: text editor ex(l) 

change the format of a text file, newform: newform(l) 

fspec: format specification in text files fspec(4) 

plock: lock process, text, or data in memory plock(2) 

tic: terminfo compiler tic(lM) 

ttt: tic-tac-toe. ttt(6) 
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data and system/ timex: time a command; report process .... timex(l) 

time: time a command time(I) 

mclock: return Fortran time accounting mclock(3F) 

execute commands at a later time, at: at(l) 

systems for optimal access time, dcopy: copy file dcopy(lM) 

time: get time time(2) 

profil: execution time profile profil(2) 

up an environment at login time, profile: setting profiled) 

stime: set time stime(2) 

time: time a command time(l) 

time: get time time(2) 

ctime: convert date and time to string ctime(3C) 

clock: report CPU time used clock (3C) 

process times, times: get process and child times (2) 

update access and modification times of a file, touch: touch (l) 

get process and child process times, times: times(2) 

file access and modification times, utime: set utime(2) 

process data and system/ timex: time a command; report .... timex(l) 
interface, tm: TM1 1 /TUI 0 magnetic tape .... tm.pdp(7) 

interface, tm: TM1 1 /TUI 0 magnetic tape tm.pdp(7) 

file, tmpfile: create a temporary tmpfile(3S) 

temporary file, tmpnam: create a name for a tmpnam(3S) 

contents routines, toe: graphical table of toc(lG) 

popen: initiate pipe to/from a process popen(3S) 

tsort: topological sort tsort(l) 

acctmerg: merge or add total accounting files acctmerg(lM) 

modification times of a file, touch: update access and touch(l) 

toupper: translate characters conv(3C) 

tplot: graphics filters tplot(lG) 

tput: query terminfo database tput(l) 

tr: translate characters tr(l) 

trace: event-tracing driver trace (7) 

ptrace: process trace ptrace(2) 

save and print VPM event traces, vpmsave: vpmsave(lM) 

function, sign: Fortran transfer-of-sign intrinsic sign(3F) 

toupper: translate characters conv(3C) 

tr: translate characters tr(l) 

ftw: walk a file tree ftw(3C) 

tsearch: manage binary search trees tsearch(3C) 

report, trenter: enter a trouble trenter(l) 

sin: trigonometric functions trig(3M) 

trenter: enter a trouble report trenter(l) 

true: provide truth values true(l) 

type, pdpl 1, vax: provide truth value about processor machid(l) 

true: provide truth values true(l) 

interface, ts: TS1 1 magnetic tape ts 1 1 (7) 

ts: TS1 1 magnetic tape interface ts 1 1 (7) 

trees, tsearch: manage binary search .... tsearch (3C) 

tsort: topological sort tsort(l) 

ttt: tic-tac-toe ttt(6) 

interface, tty: controlling terminal tty (7) 

terminal, tty: get the name of the tty Cl) 

terminal, ttyname: find name of a ttyname(3C) 

utmp file of the current/ ttyslot: find the slot in the ttyslot(3C) 

interface, ht: TU16/TE16 magnetic tape ht(7) 

tu78: TU78 magnetic tape interface tu78(7) 

interface. tu78: TU78 magnetic tape tu78(7) 

int: explicit Fortran type conversion ftype(3F) 

file: determine file type file(l) 

truth value about processor type, pdpl 1, vax: provide machid(l) 

getty: set terminal type, modes, speed, and line/ getty(lM) 

types, types: primitive system data types(5) 

types: primitive system data types types (5) 

getpw: get name from UID getpw(3C) 
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limits, ulimit: get and set user ulimit(2) 

creation mask, umask: set and get file umask(2) 

mask, umask: set file-creation mode umask(l) 

umount: unmount a file system umount(2) 

UNIX system, uname: get name of current uname(2) 

UNIX system, uname: print name of current uname(l) 

file, unget: undo a previous get of an SCCS .... unget(l) 

an SCCS file, unget: undo a previous get of unget (l) 

into input stream, ungetc: push character back ungetc(3S) 

drand48: generate uniformly distributed/ drand48(3C) 

a file, uniq: report repeated lines in uniq(l) 

mktemp: make a unique file name mktemp(3C) 

acu: Automatic Call Unit (ACU) interface acu(7) 

units: conversion program units(l) 

and boot procedures, unixboot: UNIX system startup .... unixboot(8) 
execution, uux: UNIX-to-UNIX system command . . . uux(lC) 
uuto: public UNIX-to-UNIX system file copy. . . . uuto(lC) 

entry, unlink: remove directory unlink(2) 

link: exercise link and unlink system calls link(lM) 

umount: unmount a file system umount(2) 

times of a file, touch: update access and modification .... touch(l) 
of programs, make: maintain, update, and regenerate groups .... make(l) 

bdblk: print, initialize, update bad information bdblk(lM) 

lsearch: linear search and update lsearch(3C) 

sync: update super-block sync (2) 

sync: update the super block sync(l) 

du: summarize disk usage du(l) 

stat: statistical network useful with graphical/ stat(lG) 

id: print user and group IDs and names id ( 1 ) 

setuid, setgid: set user and group IDs setuid(2) 

crontab: user crontab file crontab(l) 

character login name of the user, cuserid: get cuserid(3S) 

environ: user environment environ (5) 

disk accounting data by user ID. diskusg: generate diskusg(lM) 

getuid: get user IDs getuid(2) 

ulimit: get and set user limits ulimit(2) 

logname: return login name of user logname(3X) 

become super-user or another user.su: su(l) 

the utmp file of the current user, /find the slot in ttyslot(3C) 

write: write to another user write(l) 

mail: send mail to users or read mail mail(l) 

wall: write to all users wall(lM) 

fuser: identify processes using a file or file/ fuser(lM) 

statistics, ustat: get file system ustat(2) 

gutil: graphical utilities. gutil(lG) 

modification times, utime: set file access and utime(2) 

utmp: utmp and wtmp entry formats utmp(4) 

getutent: access utmp file entry getut(3C) 

ttyslot: find the slot in the utmp file of the current user ttyslot (3C) 

formats, utmp: utmp and wtmp entry utmp(4) 

clean-up. uuclean: uucp spool directory uuclean(lM) 

uusub: monitor uucp network uusub(lM) 

uuclean: uucp spool directory clean-up uuclean(lM) 

control, uustat: uucp status inquiry and job uustat(lC) 

system copy, uucp: UNIX system to UNIX .... uucp(lC) 

and job control, uustat: uucp status inquiry uustat(lC) 

uusub: monitor uucp network uusub (1M) 

system file copy, uuto: public UNIX-to-UNIX uuto (1C) 

command execution, uux: UNIX-to-UNIX system uux(lC) 

val: validate SCCS file val(l) 

val: validate SCCS file val(l) 

pdpl 1, vax: provide truth value about processor type machid(l) 

abs: return integer absolute value abs(3C) 

abs: Fortran absolute value abs(3F) 
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getenv: return value for environment name getenv(3C) 

ceiling, remainder, absolute value functions, /floor, floor(3M) 

putenv: change or add value to environment putenv(3C) 

values, values: machine-dependent values (5) 

true: provide truth values true(l) 

values: machine-dependent values values(5) 

/print formatted output of a varargs argument list vprintf(3S) 

/print formatted output of a varargs argument list vprintf(3X) 

argument list, varargs: handle variable varargs (5) 

varargs: handle variable argument list varargs(5) 

return Fortran environment variable, getenv: getenv (3 F) 

processor type, pdpl 1, vax: provide truth value about machid(l) 

750ops: VAX-1 1/750 console operations. . . . 750ops(8) 

verification program, vcf: VAX- 1 1/780 configuration vcf(lM) 

780ops: VAX-1 1/780 console operations. . . . 780ops(8) 

interface, vlx: VAX-1 1/780 LSI console floppy . . . vlx(lM) 

files between PDP-1 1 and VAX-1 1/780 systems, /convert .... fscv.vax(lM) 

vc: version control vc ( 1 ) 

verification program, vcf: VAX-1 1/780 configuration .... vcf(lM) 

option letter from argument vector, getopt: get getopt(3C) 

vcf: VAX- 1 1/780 configuration verification program vcf(lM) 

assert: verify program assertion assert(3X) 

vpr: Versa tec printer spooler vpr(l) 

vp: Versatec printer vp.pdp(7) 

vc: version control vc(l) 

get: get a version of an SCCS file get(l) 

sccsdiff: compare two versions of an SCCS file sccsdiff(l) 

vi: screen-oriented editor vi(l) 

vpm: Virtual Protocol Machine vpm(7) 

vpmc: compiler for the virtual protocol machine vpmc.dec(lM) 

floppy interface, vlx: VAX-1 1/780 LSI console vlx(lM) 

with label checking, volcopy: copy file systems volcopy(lM) 

file system: format of system volume fs(4) 

vp: Versatec printer vp.pdp(7) 

vpmset: connect/load VPM drivers vpmset(lM) 

vpmsave: save and print VPM event traces vpmsave(lM) 

vpm: Virtual Protocol Machine vpm(7) 

protocol machine, vpmc: compiler for the virtual vpmc.dec(lM) 

event traces, vpmsave: save and print VPM vpmsave(lM) 

drivers vpmset: connect/load VPM vpmset(lM) 

vpmtest: test KMC lines vpmtest(lM) 

vpr: Versatec printer spooler vpr(l) 

output of a varargs argument/ vprintf: print formatted vprintf(3S) 

output of a varargs argument/ vprintf: print formatted vprintf(3X) 

process, wait: await completion of wait(l) 

or terminate, wait: wait for child process to stop wait(2) 

to stop or terminate, wait: wait for child process wait(2) 

ftw: walk a file tree ftw(3C) 

wall: write to all users wall(lM) 

we: word count wc(l) 

what: identify SCCS files what(l) 

signal, signal: specify what to do upon receipt of a signal(2) 

crashes, crash: what to do when the system crash.dec(8) 

whodo: who is doing what whodo(lM) 

who: who is on the system who(l) 

who: who is on the system who(l) 

whodo: who is doing what whodo(lM) 

cd: change working directory cd(l) 

chdir: change working directory chdir(2) 

get path-name of current working directory, getcwd: getcwd(3C) 

pwd: working directory name pwd(l) 

write: write on a file write (2) 

putpwent: write password file entry putpwent(3C) 

wall: write to all users wall(lM) 
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write: write to another user write(l) 

write: write on a file write(2) 

write: write to another user write(l) 

open: open for reading or writing open (2) 

utmp: utmp and wtmp entry formats utmp(4) 

hunt-the-wumpus. wump: the game of wump(6) 

list(s) and execute command, xargs: construct argument xargs(l) 

functions, and, or, xor, not: Fortran boolean bool(3F) 

jO, jl, jn, yO, yl, yn: Bessel functions bessel(3M) 

jO, jl, jn, yO, yl, yn: Bessel functions bessel(3M) 

compiler-compiler, yacc: yet another yacc(l) 

jO, jl, jn, yO, yl, yn: Bessel functions bessel(3M) 
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INTRO (1M) 


NAME 

intro — introduction to system maintenance commands and application pro- 
grams 

DESCRIPTION 

This section describes, in alphabetical order, commands that are used chiefly 
for system maintenance and administration purposes. The commands in this 
section should be used along with those listed in Section 1 of the UNIX System 
V User Reference Manual and Sections 2, 3, 4, and 5 of the UNIX System V 
Programmer Reference Manual. References to other manual entries not of the 
form name (1M), name (7) or name($) refer to entries of the above manuals. 


COMMAND SYNTAX 

Unless otherwise noted, commands described in this section accept options and 
other arguments according to the following syntax: 

name [ optionls )] [cmdarg(s)] 
where: 


name The name of an executable file. 


option 


noargletter 

argletter 

optarg 

cmdarg 


— noargletter (s) or, 

— argletter <> optarg 

where < > is optional white space. 

A single letter representing an option without an argument. 

A single letter representing an option requiring an argument. 
Argument (character string) satisfying preceding argletter. 

Path name (or other command argument) not beginning with — 
or, — by itself indicating the standard input. 


SEE ALSO 

getopt(l), getopt(3C). 

UNIX System V User Reference Manual. 

UNIX System V Programmer Reference Manual. 
UNIX System V Administrator Guide. 


DIAGNOSTICS 

Upon termination, each command returns two bytes of status, one supplied by 
the system and giving the cause for termination, and (in the case of “normal” 
termination) one supplied by the program (see wait (2) and exit (2)). The 
former byte is 0 for normal termination; the latter is customarily 0 for success- 
ful execution and non-zero to indicate troubles such as erroneous parameters, 
bad or inaccessible data, or other inability to cope with the task at hand. It is 
called variously “exit code”, “exit status”, or “return code”, and is described 
only where special conventions are involved. 

BUGS 

Regretfully, many commands do not adhere to the aforementioned syntax. 
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NAME 

accept, reject — allow/prevent LP requests 
SYNOPSIS 

/usr/lib/accept destinations 

/usr /lib/reject [ — r[ reason]] destinations 

DESCRIPTION 

Accept allows lp( 1) to accept requests for the named destinations. A destina- 
tion can be either a printer or a class of printers. Use Ipstatf. 1) to find the 
status of destinations . 

Reject prevents lp(, 1) from accepting requests for the named destinations. A 
destination can be either a printer or a class of printers. Use Ipstati 1) to find 
the status of destinations . The following option is useful with reject. 

—rl reason] Associates a reason with preventing Ip from accepting requests. 

This reason applies to all printers mentioned up to the next -r 
option. Reason is reported by Ip when users direct requests to 
the named destinations and by Ipstati 1). If the — r option is not 
present or the — r option is given without a reason, then a 
default reason will be used. 

FILES 

/usr/spool/lp/* 

SEE ALSO 

enable(l), lp(l), lpadmin(lM), lpsched(lM), lpstat(l). 
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NAME 

acctdisk, acctdusg, accton, acctwtmp — overview of accounting and miscellane- 
ous accounting commands 

SYNOPSIS 

/usr/lib/acct/ acctdisk 

/usr/lib/acct/acctdusg t — u file] [ — p file] 

/usr/lib/acct/accton [file] 

/usr/lib/acct/acctwtmp "reason" 

DESCRIPTION 

Accounting software is structured as a set of tools (consisting of both C pro- 
grams and shell procedures) that can be used to build accounting systems. 
Acctsh (I M) describes the set of shell procedures built on top of the C pro- 
grams. 

Connect time accounting is handled by various programs that write records into 
/etc/utmp, as described in utmp (4). The programs described in acctconi 1M) 
convert this file into session and charging records, which are then summarized 
by acctmerg (1M). 

Process accounting is performed by the UNIX system kernel. Upon termination 
of a process, one record per process is written to a file (normally 
/usr/adm/pacct). The programs in acctprcl 1M) summarize this data for 
charging purposes; accfcvw.y ( 1 M) is used to summarize command usage. 
Current process data may be examined using acctcom(l). 

Process accounting and connect time accounting (or any accounting records in 
the format described in fleet (4)) can be merged and summarized into total 
accounting records by acctmerg (see tacct format in acct(4)). Prtacct (see 
acctsh (1M)) is used to format any or all accounting records. 

Acctdisk reads lines that contain user ID, login name, and number of disk 
blocks and converts them to total accounting records that can be merged with 
other accounting records. 

Acctdusg reads its standard input (usually from find / —print) and computes 
disk resource consumption (including indirect blocks) by login. If — u is given, 
records consisting of those file names for which acctdusg charges no one are 
placed in file (a potential source for finding users trying to avoid disk charges). 
If — p is given, file is the name of the password file. This option is not needed 
if the password file is /etc /pass wd. (See diskusg(lM) for more details.) 

Accton alone turns process accounting off. If file is given, it must be the name 
of an existing file, to which the kernel appends process accounting records (see 
acct(2) and acct (4)). 

Acctwtmp writes a utmp (.A) record to its standard output. The record contains 
the current time and a string of characters that describe the reason. A record 
type of ACCOUNTING is assigned (see utmp (A)). Reason must be a string of 
11 or less characters, numbers, $, or spaces. For example, the following are 
suggestions for use in reboot and shutdown procedures, respectively: 

acctwtmp 'uname' > > /etc/wtmp 
acctwtmp "file save" >> /etc/wtmp 


FILES 

/etc/passwd 

/usr/lib/acct 

/usr/adm/pacct 

/etc/wtmp 


used for login name to user ID conversions 
holds all accounting commands listed in 
sub-class 1M of this manual 
current process accounting file 
login/logoff history file 
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ACCT(lM) 


SEE ALSO 

acctcms(lM), acctcon(lM), acctmerg(lM), acctprc(lM), acctsh(lM), 
diskusg(lM), fwtmp(lM), runacct(lM), acctcom(l), acct(2), acct(4), 
utmp(4). 

UNIX Accounting System in the UNIX System V Administrator Guide. 
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NAME 

acctcms — command summary from per-process accounting records 
SYNOPSIS 

/usr/lib/acct/acctcms [options] files 
DESCRIPTION 

Acctcms reads one or more files , normally in the form described in acct (4) . It 
adds all records for processes that executed identically-named commands, sorts 
them, and writes them to the standard output, normally using an internal sum- 
mary format. The options are: 

—a Print output in ASCII rather than in the internal summary format. 
The output includes command name, number of times executed, total 
kcore-minutes, total CPU minutes, total real minutes, mean size (in K), 
mean CPU minutes per invocation, “hog factor”, characters transferred, 
and blocks read and written, as in acctcom(l) . Output is normally 
sorted by total kcore-minutes. 

— c Sort by total CPU time, rather than total kcore-minutes. 

— j Combine all commands invoked only once under “»*«other”. 

— n Sort by number of command invocations. 

— s Any file names encountered hereafter are already in internal summary 

format. 

— t Process all records as total accounting records. The default internal 

summary format splits each field into prime and non-prime time parts. 
This option combines the prime and non-prime time parts into a single 
field that is the total of both, and provides upward compatibility with 
old (i.e., UNIX System V) style acctcms internal summary format 
records. 

The following options may be used only with the -a option. 

— p Output a prime-time-only command summary. 

— o Output a non-prime (offshift) time only command summary. 

When — p and — o are used together, a combination prime and non-prime time 
report is produced. All the output summaries will be total usage except 
number of times executed, CPU minutes, and real minutes which will be split 
into prime and non-prime. 

A typical sequence for performing daily command accounting and for maintain- 
ing a running total is: 

acctcms file ... > today 

cp total previoustotal 

acctcms — s today previoustotal > total 

acctcms —a — s today 

SEE ALSO 

acct(lM), acctcon(lM), acctmerg(lM), acctprc(lM), acctsh(lM), 
fwtmp(lM), runacct(lM), acctcom(l), acct(2), acct(4), utmp(4). 

BUGS 

Unpredictable output results if — t is used on new style internal summary for- 
mat files, or if it is not used with old style internal summary format files. 
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NAME 

acctconl, acctcon2 — connect-time accounting 
SYNOPSIS 

/usr/lib/acct/acctconl [options] 

/ usr/lib/acct/ acctconl 
DESCRIPTION 

Acctconl converts a sequence of login/logoff records read from its standard 
input to a sequence of records, one per login session. Its input should normally 
be redirected from /etc/wtmp. Its output is ASCII, giving device, user ID, login 
name, prime connect time (seconds), non-prime connect time (seconds), session 
starting time (numeric), and starting date and time. The options are: 

— p Print input only, showing line name, login name, and time (in both 
numeric and date/time formats). 

— t Acctconl maintains a list of lines on which users are logged in. When 
it reaches the end of its input, it emits a session record for each line 
that still appears to be active. It normally assumes that its input is a 
current file, so that it uses the current time as the ending time for 
each session still in progress. The — t flag causes it to use, instead, the 
last time found in its input, thus assuring reasonable and repeatable 
numbers for non-current files. 

—1 file File is created to contain a summary of line usage showing line name, 
number of minutes used, percentage of total elapsed time used, 
number of sessions charged, number of logins, and number of logoffs. 
This file helps track line usage, identify bad lines, and find software 
and hardware oddities. Hang-up, termination of login ( 1) and termi- 
nation of the login shell each generate logoff records, so that the 
number of logoffs is often three to four times the number of sessions. 
See ini til M) and utmpi 4). 

— o file File is filled with an overall record for the accounting period, giving 
starting time, ending time, number of reboots, and number of date 
changes. 

Acctcon2 expects as input a sequence of login session records and converts 
them into total accounting records (see tacct format in accti 4)). 

EXAMPLES 

These commands are typically used as shown below. The file ctmp is created 
only for the use of acctprci 1M) commands: 

acctconl — t —1 lineuse — o reboots <wtmp | sort -bin +2 >ctmp 
acctcon2 Cctmp | acctmerg >ctacct 

FILES 

/etc/wtmp 
SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctmerg(lM), acctprc(lM), 
acctsh(lM), fwtmp(lM), init(lM), login(l), runacct(lM), acct(2), acct(4), 
utmp(4). 

BUGS 

The line usage report is confused by date changes. Use wtmpfix (see 
fwtmpi 1M)) to correct this situation. 
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NAME 

acctmerg — merge or add total accounting files 
SYNOPSIS 

/usr/lib/acct/acctmerg [options] [file] . . . 

DESCRIPTION 

Acctmerg reads its standard input and up to nine additional files, all in the 
tacct format (see acct{ 4)) or an ASCII version thereof. It merges these inputs 
by adding records whose keys (normally user ID and name) are identical, and 
expects the inputs to be sorted on those keys. Options are: 

—a Produce output in ASCII version of tacct. 

— i Input files are in ASCII version of tacct. 

— p Print input with no processing. 

— t Produce a single record that totals all input. 

— u Summarize by user ID, rather than user ID and name. 

—v Produce output in verbose ASCII format, with more precise notation for 
floating point numbers. 

EXAMPLES 

The following sequence is useful for making “repairs” to any file kept in this 
format: 

acctmerg — v <filel >file2 

edit file2 as desired . . . 
acctmerg — i <file2 >filel 

SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctcon(lM), acctprc(lM), acctsh(lM), 
fwtmp(lM), runacct(lM), acct(2), acct(4), utmp(4). 


- 1 - 



ACCTPRC(IM) 


ACCTPRC(IM) 


NAME 

acctprcl, acctprc2 — process accounting 
SYNOPSIS 

/usr/lib/acct/acctprcl [ctmp] 

/usr/lib/acct/acctprc2 

DESCRIPTION 

Acctprcl reads input in the form described by accf(4), adds login names 
corresponding to user IDs, then writes for each process an ASCII line giving 
user ID, login name, prime CPU time (tics), non-prime CPU time (tics), and 
mean memory size (in memory segment units). If ctmp is given, it is expected 
to contain a list of login sessions, in the form described in acctcon (1M), sorted 
by user ID and login name. If this file is not supplied, it obtains login names 
from the password file. The information in ctmp helps it distinguish among 
different login names that share the same user ID. 

Acctprc2 reads records in the form written by acctprcl , summarizes them by 
user ID and name, then writes the sorted summaries to the standard output as 
total accounting records. 

These commands are typically used as shown below: 

acctprcl ctmp </usr/adm/pacct | acctprc2 >ptacct 

FILES 

/etc/passwd 
SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), 
acctsh(lM), cron(lM), fwtmp(lM), runacct(lM), acct(2), acct(4), utmp(4). 

BUGS 

Although it is possible to distinguish among login names that share user IDs for 
commands run normally, it is difficult to do this for those commands run from 
cron (1M), for example. More precise conversion can be done by faking login 
sessions on the console via the acctwtmp program in accti. 1M). 

CAVEAT 

A memory segment of the mean memory size is a unit of measure for the 
number of bytes in a logical memory segment on a particular processor. For 
example, on a PDP- 11/70 this measure would be in 64-byte units, while on a 
VAX 11/780 it would be in 512-byte units. 
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NAME 

chargefee, ckpacct, dodisk, lastlogin, monacct, nulladm, prctmp, prdaily, 
prtacct, runacct, shutacct, startup, turnacct — shell procedures for accounting 

SYNOPSIS 

/usr/lib/acct/chargefee login-name number 
/usr/lib/acct/ckpacct [blocks] 

/usr/lib/acct/dodisk [- 0 ] [files ...] 

/usr/lib/acct/lastlogin 
/usr/lib/acct/monacct number 
/usr/lib/acct/nulladm file 
/usr/lib/acct/prctmp 

/usr/lib/acct/prdaily [-1] [-c] [ mmdd ] 

/usr/lib/acct/prtacct file [ "heading" ] 

/usr/lib/acct/runacct [mmdd] [mmdd state] 

/usr/lib/acct/shutacct [ "reason" ] 

/usr/Iib/acct/startup 
/usr/lib/acct/turnacct on | off | switch 
DESCRIPTION 

Chargefee can be invoked to charge a number of units to login-name . A 
record is written to /usr/adm/fee, to be merged with other accounting records 
during the night. 

Ckpacct should be initiated via cronl 1M). It periodically checks the size of 
/usr/adm/pacct. If the size exceeds blocks, 1000 by default, turnacct will be 
invoked with argument switch. If the number of free disk blocks in the /usr 
file system falls below 500, ckpacct will automatically turn off the collection of 
process accounting records via the off argument to turnacct. When at least this 
number of blocks is restored, the accounting will be activated again. This 
feature is sensitive to the frequency at which ckpacct is executed, usually by 
cron. 

Dodisk should be invoked by cron to perform the disk accounting functions. 
By default, it will do disk accounting on the special files in /etc/checklist. If 
the — o flag is used, it will do a slower version of disk accounting by login 
directory. Files specify the one or more filesystem names where disk account- 
ing will be done. If files are used, disk accounting will be done on these filesys- 
tems only. If the — o flag is used, files should be mount points of mounted 
filesystem. If omitted, they should be the special file names of mountable 
filesystems. 

Lastlogin is invoked by runacct to update /usr/adm/acct/sum/loginlog, which 
shows the last date on which each person logged in. 

Monacct should be invoked once each month or each accounting period. 
Number indicates which month or period it is. If number is not given, it 
defaults to the current month (01—12). This default is useful if monacct is to be 
executed via cron (1M) on the first day of each month. Monacct creates sum- 
mary files in /usr/adm/acct/fiscal and restarts summary files in 
/usr/ adm/acct/ sum. 

Nulladm creates file with mode 664 and insures that owner and group are 
adm. It is called by various accounting shell procedures. 
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Prctmp can be used to print the session record file (normally 
/usr/adm/acct/nite/ctmp created by acctconl (see acctconi 1M)). 

Prdaily is invoked by runacct to format a report of the previous day’s account- 
ing data. The report resides in /usr/adm/acct/sum/rprtmm<W where mmdd is 
the month and day of the report. The current daily accounting reports may be 
printed by typing prdaily. Previous days’ accounting reports can be printed by 
using the mmdd option and specifying the exact report date desired. The — 1 
flag prints a report of exceptional usage by login id for the specifed date. Pre- 
vious daily reports are cleaned up and therefore inaccessible after each invoca- 
tion of monacct. The — c flag prints a report of exceptional resource usage by 
command, and may be used on current day’s accounting data only. 

Prtacct can be used to format and print any total accounting (tacct) file. 

Runacct performs the accumulation of connect, process, fee, and disk account- 
ing on a daily basis. It also creates summaries of command usage. For more 
information, see runacct (1M) . 

Shutacct should be invoked during a system shutdown (usually in 
/etc/shutdown) to turn process accounting off and append a “reason” record to 

/etc/wtmp. 

Startup should be called by /etc/rc to turn the accounting on whenever the 
system is brought up. 

Turnacct is an interface to accton (see accr(lM)) to turn process accounting 
on or off. The switch argument turns accounting off, moves the current 
/usr/adm/pacct to the next free name in /usr/adm/pacct incr (where incr is a 
number starting with 1 and incrementing by one for each additional pacct file), 
then turns accounting back on again. This procedure is called by ckpacct and 
thus can be taken care of by the cron and used to keep pacct to a reasonable 
size. 


FILES 


/usr/adm/fee 

/usr/adm/pacct 

/usr/adm/pacct* 

/etc/wtmp 

/usr/lib / acct/ ptelus.awk 


/usr/adm/ acct/nite 
/usr/lib/acct 

/usr/adm/acct/sum 


accumulator for fees 
current file for per-process accounting 
used if pacct gets large and during 
execution of daily accounting procedure 
login/logoff summary 
contains the limits for exceptional 
usage by login id 

/usr/lib/acct/ptecms.awk contains the limits for exceptional 
usage by command name 
working directory 

holds all accounting commands listed in 
sub-class 1M of this manual 
summary directory, should be saved 


SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), 
acctprc(lM), cron(lM), diskusg(lM), fwtmp(lM), runacct (1M), acct (2), 
acct (4), utmp(4). 
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NAME 

bcopy — interactive block copy 

SYNOPSIS 

/etc /bcopy 

DESCRIPTION 

Bcopy dates from a time when neither the UNIX system file nor the DEC disk 
drives were as reliable as they are now. Bcopy copies from and to files starting 
at arbitrary block (512-byte) boundaries. 

The following questions are asked: 

to: (you name the file or device to be copied to), 

offset: (you provide the starting “to” block number) . 
from: (you name the file or device to be copied from) . 

offset: (you provide the starting “from” block number), 
count: (you reply with the number of blocks to be copied) . 

After count is exhausted, the from question is repeated (giving you a chance to 
concatenate blocks at the to+ofTset+count location) . If you answer from with a 
carriage return, everything starts over. 

Two consecutive carriage returns terminate bcopy. 

SEE ALSO 

cpio(l), dd(l). 
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NAME 

bdblk - print, initialize, update or recover bad sector information on disk packs 
SYNOPSIS 

/etc/bdblk option unit [sector ... ] 

DESCRIPTION 

Bdblk can be used to print, initialize, update or recover the bad block informa- 
tion stored on disk that is used by the disk drivers to implement bad sector 
replacement. 

The bad sector information on 3B 20 computer is located in the last sector of 
the first cylinder of the disk pack. The bad sector information on DEC is 
located in the last sector of the last cylinder of the disk pack. 

Replacement sectors are allocated starting with the first sector before the bad 
sector information and working backwards toward the beginning of the disk. A 
maximum of 126 bad sectors are supported. The position of the bad sector in 
the bad sector table determines which replacement sector it corresponds to. 

The bad sector information structure is as follows: 
struct badblk { 

int bb magic; /* bad block information magic number */ 

int bb count; /* number of bad sectors in table »/ 

daddr bb_blkno[ 1 26]; /* sector number of bad sector */ 

); 

Bdblk is invoked by giving an option and the unit number of the disk drive 
number. The option is specified by one of the following letters: 

p It reads the bad sector information from the specified unit and 

prints out the bad sector information. 

i It verifies the format of the specified unit and initializes the bad 

sector information on disk. 

u It verifies the format of the specified unit and updates the bad sec- 

tor information on disk. 

r It may be invoked by giving a list of bad sectors. It will then write 

the supplied information onto the disk. This option should only be 
used to restore known bad sector information which was destroyed. 

SEE ALSO 

dskfmt(lM), format(lM), dsk(7), gd(7). 

WARNINGS 

After having changed the bad sector information on disk, the disk should be 
put out of service to insure the system bad block information table for that unit 
is current. 
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NAME 

brc, bcheckrc, rc, powerfail — system initialization shell scripts 

SYNOPSIS 

/etc /brc 

/etc /bcheckrc 
/etc/rc 

/etc/powerfail 

DESCRIPTION 

Except for powerfail, these shell procedures are executed via entries in 
/etc/inittab by init(\ M) when the system is changed out of SINGLE USER 
mode. Powerfail is executed whenever a system power failure is detected. 

The brc procedure clears the mounted file system table, /etc/mnttab (see 
mnttabi 4)), and loads any programmable microprocessors with their appropri- 
ate scripts. 

The bcheckrc procedure performs all the necessary consistency checks to 
prepare the system to change into multi-user mode. It will prompt to set the 
system date and to check the file systems with /scfc(lM). 

The rc procedure starts all system daemons before the terminal lines are 
enabled for multi-user mode. In addition, file systems are mounted and 
accounting, error logging, system activity logging and the Remote Job Entry 
(RJE) system are activated in this procedure. 

The powerfail procedure is invoked when the system detects a power failure 
condition. Its chief duty is to reload any programmable microprocessors with 
their appropriate scripts, if suitable. It also logs the fact that a power failure 
occurred. 

These shell procedures, in particular rc may be used for several run-level states. 
The Wio(l) command may be used to get the run-level information. 

SEE ALSO 

fsck(lM), init(lM), shutdown(lM), who(l), inittab(4), mnttab(4), vpm(7). 
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NAME 

checkall — faster file system checking procedure 

SYNOPSIS 

/etc/clieckall 

DESCRIPTION 

The checkall procedure is a prototype and must be modified to suit local condi- 
tions. The following will serve as an example: 

# check the root file system by itself 
fsck /dev/dsk/OsO 

# dual fsck of drives 0 and 1 

dfsck /dev/rdsk/Os[ 12345] — /dev/rdsk/lsl 

In the above example (where /dev/rdsk/lsl is 320K blocks and 
/dev/rdsk/0s[12345l are each 65K or less), a previous sequential fsck took 19 
minutes. The checkall procedure takes 1 1 minutes. 

Dfsck is a program that permits an operator to interact with two /scfc(lM) 
programs at once. To aid in this, dfsck will print the file system name for each 
message to the operator. When answering a question from dfsck, the operator 
must prefix the response with a 1 or a 2 (indicating that the answer refers to 
the first or second file system group). 

Due to the file system load balancing required for dual checking, the 
dfsck (1M) command should always be executed through the checkall shell pro- 
cedure. 

In a practical sense, the file systems are divided as follows: 

dfsck file_systems_on_drive_0 — file_systems_on_drive_l 
dfsck file_systems_on_drive_2 — file_systems_on_drive_3 

A three-drive system can be handled by this more concrete example (assumes 
two large file systems per drive): 

dfsck /dev/dsk/3sl /dev/dsk/0s[l4] - /dev/dsk/ls[ 14] /dev/dsk/3s4 

Note that the first file system on drive 3 is first in the filesystemsl list and is 
last in the filesystems2 list assuring that references to that drive will not over- 
lap at execution time. 

WARNINGS 

1. Do not use dfsck to check the root file system. 

2. On a check that requires a scratch file (see — t above), be careful not to use 
the same temporary file for the two groups (this is sure to scramble the file 
systems) . 

3. The dfsck procedure is useful only if the system is set up for multiple physi- 
cal I/O buffers. 

SEE ALSO 

dfsck(lM), fsck(lM). 

Setting Up the UNIX System in the UNIX System V Administrator Guide. 
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NAME 

chroot — change root directory for a command 
SYNOPSIS 

/etc/chroot newroot command 
DESCRIPTION 

The given command is executed relative to the new root. The meaning of any 
initial slashes (/) in path names is changed for a command and any of its chil- 
dren to newroot. Furthermore, the initial working directory is newroot. 

Notice that: 

chroot newroot command >x 

will create the file x relative to the original root, not the new one. 

This command is restricted to the super-user. 

The new root path name is always relative to the current root: even if a chroot 
is currently in effect, the newroot argument is relative to the current root of the 
running process. 

SEE ALSO 

chdir(2). 

BUGS 

One should exercise extreme caution when referencing special files in the new 
root file system. 
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NAME 

clri — clear i-node 
SYNOPSIS 

/etc/clri file-system i-number ... 

DESCRIPTION 

Clri writes zeros on the 64 bytes occupied by the i-node numbered i-number. 
File-system must be a special file name referring to a device containing a file 
system. After clri is executed, any blocks in the affected file will show up as 
“missing” in an /ycfc(lM) of the file-system. This command should only be 
used in emergencies and extreme care should be exercised. 

Read and write permission is required on the specified file-system device. The 
i-node becomes allocatable. 

The primary purpose of this routine is to remove a file which for some reason 
appears in no directory. If it is used to zap an i-node which does appear in a 
directory, care should be taken to track down the entry and remove it. Other- 
wise, when the i-node is reallocated to some new file, the old entry will still 
point to that file. At that point removing the old entry will destroy the new file. 
The new entry will again point to an unallocated i-node, so the whole cycle is 
likely to be repeated again and again. 

SEE ALSO 

fsck(lM), fsdb(lM), ncheck(lM), fs(4). 

BUGS 

If the file is open, clri is likely to be ineffective. 
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NAME 

config — configure a UNIX system 
SYNOPSIS 

/etc/config [ — n ] [ — t ] [ —1 file ] [ — c file ] [ — m file ] dfile 
DESCRIPTION 

Config is a program that takes a description of a UNIX system and generates 
two files. One file provides information regarding the interface between the 
hardware and device handlers. The other file is a C program defining the 
configuration tables for the various devices on the system. 

The -n option produces a non-separated I and space low.s core image for the 
PDP-11 (this is for small systems, i.e., PDP11/23 and 11/34). 

The —1 option specifies the name of the hardware interface file; low.s is the 
default name on the PDP-11; univec.c is the default name on the VAX-11. 

The -c option specifies the name of the configuration table file; conf.c is the 
default name. 

The -m option specifies the name of the file that contains all the information 
regarding supported devices; /etc/master is the default name. This file is sup- 
plied with the UNIX system and should not be modified unless the user fully 
understands its construction. 

The — t option requests a short table of major device numbers for character 
and block type devices. This can facilitate the creation of special files. 

The user must supply dfile; it must contain device information for the user’s 
system. This file is divided into two parts. The first part contains physical dev- 
ice specifications. The second part contains system-dependent information. 
Any line with an asterisk (*) in column 1 is a comment. 

All configurations are assumed to have the following devices: 

one DL11 (for the system console) 

one KW1 1-L line clock or KW1 1-P programmable clock 

with standard interrupt vectors and addresses. These two devices must not be 
specified in dfile. Note that the UNIX operating system needs only one clock, 
but can handle both types. 

First Part of dfile 

Each line contains up to six fields, delimited by blanks and/or tabs in the fol- 
lowing format: 

devname vector address bus number nexus 

where devname is the name of the device (as it appears in the /etc/master dev- 
ice table), vector is the interrupt vector location (octal), address is the device 
address (octal), bus is the bus request level (4 through 7), number is the 
number (decimal) of devices associated with the corresponding controller, and 
nexus is the nexus number of the UNIBUS adapter (VAX-1 1/780 only) associ- 
ated with this device. Number is optional, and if omitted, a default value 
which is the maximum value for that controller is used. Nexus is optional, and 
if omitted, a default value appropriate for each machine type will be used. If 
nexus is specified, then number must be specified as well. 

There are certain drivers that may be provided with the system, that are actu- 
ally pseudo-device drivers; that is, there is no real hardware associated with the 
driver. Drivers of this type are identified on their respective manual entries. 
When these devices are specified in the description file, the interrupt vector , 
device address, and bus request level must all be zero. 
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If the device is a VAX-11 massbus adapter, then vector is the adapter nexus 
number, and address must be zero. 

Second Part of dfile 

The second part contains three different types of lines. Note that all 
specifications of this part are required, although their order is arbitrary. 

1. Root /pipe /dump device specification 
Three lines of three fields each: 

root devname minor 

pipe devname minor 

dump devname minor 

where minor is the minor device number (in octal). 

2. Swap device specification 

One line that contains five fields as follows: 

swap devname minor swplo nswap 

where swplo is the lowest disk block (decimal) in the swap area and nswap is 
the number of disk blocks (decimal) in the swap area. 

3. Parameter specification 

Several lines of two fields each as follows ( number is decimal): 


buffers 

number 

sabufs 

number (zero on the VAX-1 1) 

i-nodes 

number 

files 

number 

mounts 

number 

coremap 

number (PDP-11 only) 

swapmap 

number 

calls 

number 

procs 

number 

maxproc 

number 

texts 

number 

clists 

number 

hashbuf 

number 

physbuf 

number 

x251inks 

number 

x25bufs 

number 

x25map 

number 

x25bytes 

number 

iblocks 

number (PDP-11 only) 

power 

0 or 1 

mesg 

0 or 1 

sema 

0 or 1 

shmem 

0 or 1 (VAX-1 1 only) 

maus 

0 or 1 (PDP-11 only) 


EXAMPLE 

To configure a PDP- 11/70 system with the following devices: 
one RP06 disk drive controller with 6 drives 

one DH11 asynchronous multiplexer with 16 lines (default number) 

one DM1 1 modem control with 16 lines (for the DHll) 

one DHll asynchronous multiplexer with 8 lines 

one DM11 modem control with 8 lines (for the DHll) 

one LP11 line printer 

one TUI 6 tape drive controller with 2 drives 
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one DL1 1 asynchronous interface 

Note that the UNIX system only supports DH11 units that require correspond- 
ing DM11 units. It is wise to specify them in DH-DM pairs to facilitate under- 
standing the configuration. Note also that, in the preceding case, the DL11 
that is specified is in addition to the DL11 that was part of the initial system. 
We must also specify the following parameter information: 
root device is an RP06 (drive 0, section 0) 
pipe device is an RP06 (drive 0, section 0) 
swap device is an RP06 (drive 1, section 4), 

with a swplo of 6000 and an nswap of 2000 
dump device is a TUI 6 (drive 0) 
number of buffers is 35 
number of system addressable buffers is 12 
number of processes is 150 
maximum number of processes per user ID is 25 
number of mounts is 8 
number of i-nodes is 120 
number of files is 120 
number of calls is 30 
number of texts is 35 
number of character buffers is 150 
number of coremap entries is 50 
number of swapmap entries is 50 
power fail recovery is to be included 
messages are to be included 
semaphores are to be included 

one pseudo device driver for the Operating System Profiler 
The actual system configuration would be specified as follows: 


rp06 

254 

776700 

5 

6 

dhl 1 

320 

760020 

5 


dml 1 

300 

770500 

4 


dhl 1 

330 

760060 

5 

8 

dml 1 

304 

770510 

4 

8 

lpll 

200 

775514 

5 


tul6 

224 

772440 

5 

2 

dill 

350 

775610 

5 


prf 

0 

0 

0 


root 

rp06 

0 



pipe 

rp06 

0 



swap 

rp06 

14 

6000 

2000 

dump 

tul6 

0 




* Comments may be inserted in this manner 

buffers 35 

sabufs 12 

procs 1 50 

maxproc 25 

mounts 8 

i-nodes 120 

files 120 

calls 30 

texts 35 

clists 150 

coremap 50 

swapmap 50 

power 1 

msg 1 

sema 1 
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FILES 

/etc/master 

low.s 

univec.c 

conf.c 


default input master device table 
default output hardware interface file for PDP-11 
default output hardware interface file for the VAX- 11 
default output configuration table file 


SEE ALSO 

sysdef(lM), master (4). 


Setting Up the UNIX System in the UNIX System V Administrator Guide. 
DIAGNOSTICS 

Diagnostics are routed to the standard output and are self-explanatory. 

BUGS 

The -t option does not know about devices that have aliases. For example, a 
TE16 (an alias for a TUI 6) will show up as a TUI 6; however, the major device 
numbers are always correct. 
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NAME 

cpset - install object files in binary directories 
SYNOPSIS 

cpset [-ol object directory [mode owner group] 

DESCRIPTION 

Cpset is used to install the specified object file in the given directory. The 
mode, owner, and group, of the destination file may be specified on the com- 
mand line. If this data is omitted, two results are possible: 

If the user of cpset has administrative permissions (that is, the user’s 
numerical ID is less than 100), the following defaults are provided: 

mode — 0755 
owner — bin 
group — bin 

If the user is not an administrator, the default, owner, and group of the 
destination file will be that of the invoker. 

An optional argument of — o will force cpset to move object to OLD object in 
the destination directory before installing the new object. 

For example: 

cpset echo /bin 0755 bin bin 
cpset echo /bin 
cpset echo /bin/echo 

All the examples above have the same effect (assuming the user is an adminis- 
trator). The file echo will be copied into /bin and will be given 0755, bin, bin 
as the mode, owner, and group, respectively. 

Cpset utilizes the file /usr/src/destinations to determine the final destination of 
a file. The locations file contains pairs of path names separated by spaces or 
tabs. The first name is the "official" destination (for example: /bin/echo). The 
second name is the new destination. For example, if echo is moved from /bin 
to /usr/bin, the entry in /usr/src/destinations would be: 

/bin/echo /usr/bin/echo 

When the actual installation happens, cpset verifies that the "old" path name 
does not exist. If a file exists at that location, cpset issues a warning and con- 
tinues. This file does not exist on a distribution tape; it is used by sites to track 
local command movement. The procedures used to build the source will be 
responsible for defining the "official" locations of the source. 

Cross Generation 

The environment variable ROOT will be used to locate the destination file (in 
the form $ROOT/usr/src/destinations) . This is necessary in the cases where 
cross generation is being done on a production system. 

SEE ALSO 

install(lM), make(l), mk(8). 
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NAME 

crash — examine system images 
SYNOPSIS 

/etc/crash [ system ] [ namelist ] 

DESCRIPTION 

Crash is an interactive utility for examining an operating system core image. 
It has facilities for interpreting and formatting the various control structures in 
the system and certain miscellaneous functions that are useful when perusing a 
dump. 

The arguments to crash are the file name where the system image can be 
found and a namelist file to be used for symbol values. 

The default values are /dev/mem and /unix; hence, crash with no arguments 
can be used to examine an active system. If a system image file is given, it is 
assumed to be a system core dump and the default process is set to be that of 
the process running at the time of the crash. This is determined by a value 
stored in a fixed location by the dump mechanism. 

COMMANDS 

Input to crash is typically of the form: 

command [ options ] [ structures to be printed ]. 

When allowed, options will modify the format of the printout. If no specific 
structure elements are specified, all valid entries will be used. As an example, 
proc - 12 15 3 would print process table slots 12, 15, and 3 in a long format! 
while proc would print the entire process table in standard format. 

In general, those commands that perform I/O with addresses assume hexade- 
cimal on 32-bit machines and octal on 16-bit machines. 

The current repertory consists of: 

user [ list of process table entries ] 

Aliases: uarea, u_area, u. 

Print the user structure of the named process as determined by the 
information contained in the process table entry. If no entry number is 
given, the information from the last executing process will be printed. 
Swapped processes produce an error message. 

trace [ — r] [ list of process table entries ] 

Aliases: t. 

Generate a kernel stack trace of the current process. If the -r option 
is used, the trace begins at the saved stack frame pointer in kfp. Oth- 
erwise the trace starts at the bottom of the stack and attempts to find 
valid stack frames deeper in the stack. If no entry number is given, 
the information from the last executing process will be printed. 

kfp [ stack frame pointer ] 

Aliases: r5, fp. 

Print the program’s idea of the start of the current stack frame (set 
initially from a fixed location in the dump) if no argument is given, or 
set the frame pointer to the supplied value. 

stack [ list of process table entries ] 

Aliases: stk, s, kernel, k. 

Format a dump of the kernel stack of a process. The addresses shown 
are virtual system data addresses rather than true physical locations. 
If no entry number is given, the information from the last executing 
process will be printed. 
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proc [ — [r] ] [ list of process table entries ] 

Aliases: ps, p. 

Format the process table. The — r option causes only runnable 
processes to be printed. The — alone generates a longer listing. 

pcb [ list of process table entries ] 

Print the process control block of the current process. The process con- 
trol block is a part of the user area (VAX-11/780 only). If no entry 
number is given, the information from the last executing process will 
be printed. 

i-node [ — ] [ list of i-node table entries ] 

Aliases: ino, i. 

Format the i-node table. The — option will also print the i-node data 
block addresses. 

file [ list of file table entries ] 

Aliases: files, f. 

Format the file table. 

mount [ list of mount table entries ] 

Aliases: mnt, m. 

Format the mount table. 

text [ list of text table entries ] 

Aliases: txt, x. 

Format the text table. 

tty [ type ] [ - 1 [ list of tty entries 1 

Aliases: term ( also dz and dh are aliases on DEC machines). 

Print the tty structures. The type argument determines which struc- 
ture will be used (such as kl, dh, dz, or dzb on DEC equipment; tn83, 
tn74, or tn4 on the 3B 20 computers). No default type is provided. 
However, once specified, the last type is remembered. The — option 
prints the srty(l) parameters for the given line. 

stat Print certain statistics found in the dump. These include the panic 
string (if a panic occurred), time of crash, system name, and the regis- 
ters saved in low memory by the dump mechanism. 

var Aliases: tunables, tunable, tune, v. 

Print the tunable system parameters. 

buf [ list of buffer headers ] 

Aliases: hdr, bufhdr. 

Format the system buffer headers. 

buffer [ format ] [ list of buffers ] 

Alias: b. 

Print the data in a system buffer according to format. If format is 
omitted, the previous format is used. Valid formats include decimal, 
octal, hex, character, byte, directory, i-node, and write. The last 
creates a file in the current directory (see FILES) containing the buffer 
data. 

callout Aliases: calls, call, c, timeout, time, tout. 

Print all entries in the callout table. 

map [ list of map names ] 

Format the named system map structures. 

nm [ list of symbols ] 

Print symbol value and type as found in the namelist file. 
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CRASH (1M) 


CRASH (1M) 


ts [ list of text addresses ] 

Find the closest text symbols to the given addresses. 

ds [ list of data addresses ] 

Find the closest data symbols to the given addresses. 

od [ symbol name or address ] [ count ] [ format ] 

Aliases: dump, rd. 

Dump count data values starting at the symbol value or address given 
according to format. Allowable formats are octal, longoct, decimal, 
longdec, character, hex, or byte. 


semalog [ n ] 

Alias: slog. 

Print the log of semaphore activity. It is printed in chronological order. 
The optional numeric argument is used to request the n most recent 
entries. If the argument is omitted, the entire log is printed. This com- 
mand applies to the 3B 20A computers only. 

! Escape to shell. 


q 

ALIASES 


Exit from crash. 

Print synopsis of commands. 


There are built-in aliases for many of the formats as well as those listed for the 
commands. Some of them are: 


byte 

character 

decimal 

directory 

hexadecimal 

i-node 

longdec 

longoct 

octal 

write 


b. 

char, c. 
dec, e. 

direct, dir, d. 
hexadec, hex, h, x. 
ino , i. 

Id, D. 
lo, O. 
oct, o. 
w. 


FILES 

/usr/include/sys/*.h 
/dev/ mem 
/unix 
buf.# 


header files for table and structure info 

default system image file 

default namelist file 

files created containing buffer data 


SEE ALSO 

mount(lM), nm(l), ps(l), sh(l), stty(l), crash(8). 


BUGS 

Most flags are abbreviated and will have little meaning to the uninitiated user. 
A source listing of the system header files at hand would be most useful while 
using crash. 

Stack tracing of the current process on a running system does not work. 
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CRON (1M) 


CRON(lM) 


NAME 

cron - clock daemon 

SYNOPSIS 

/etc/cron 

DESCRIPTION 

Cron executes commands at specified dates and times. Regularly scheduled 
commands can be specified according to instructions found in crontab files; 
users can submit their own crontab file via the crontab command. Commands 
which are to be executed only once may be submitted via the at command. 
Since cron never exits, it should only be executed once. This is best done by 
running cron from the initialization process through the file /etc/rc (see 
init{ 8)). 

Cron only examines crontab files and at command files during process initializa- 
tion and when a file changes. This reduces the overhead of checking for new or 
changed files at regularly scheduled intervals. 

FILES 

/usr/lib/cron main cron directory 

/usr/lib/cron/log accounting information 
/usr/spool/cron spool area 

SEE ALSO 

at(l), crontab(l), sh(l), init(8). 

DIAGNOSTICS 

A history of all actions taken by cron are recorded in /usr/lib/cron/log. 
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DCOPY(IM) 


DCOPY(lM) 


NAME 

dcopy — copy file systems for optimal access time 
SYNOPSIS 

/etc/dcopy [ — sX] [—an] [— d] [ — v] [ — ffsize[:isize]] inputfs outputfs 
DESCRIPTION 

Dcopy copies file system inputfs to outputfs. Inputfs is the existing file system; 
outputfs is an appropriately sized file system, to hold the reorganized result. 
For best results inputfs should be the raw device and outputfs should be the 
block device. Dcopy should be run on unmounted file systems (in the case of 
the root file system, copy to a new pack). With no arguments, dcopy copies 
files from inputfs compressing directories by removing vacant entries, and spac- 
ing consecutive blocks in a file by the optimal rotational gap. The possible 
options are 

-sX supply device information for creating an optimal organization of 
blocks in a file. The forms of X are the same as the -s option of 
fsck ( 1 M) . 

-an place the files not accessed in n days after the free blocks of the 
destination file system (default for n is 7). If no n is specified then 
no movement occurs. 

-d leave order of directory entries as is (default is to move sub- 

directories to the beginning of directories). 

-v currently reports how many files were processed, and how big the 

source and destination freelists are. 

— f fsize[:isize] 

specify the outputfs file system and i-node list sizes (in blocks). If 
the option (or lisize) is not given, the values from the inputfs are 
used. 

Dcopy catches interrupts and quits and reports on its progress. To terminate 
dcopy send a quit signal, and dcopy will no longer catch interrupts or quits. 

SEE ALSO 

fsck(lM), mkfs(lM), ps ( 1 ) . 
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DEVNM(IM) 


NAME 

devnm — device name 

SYNOPSIS 

/etc/devnm [names] 

DESCRIPTION 

Devnm identifies the special file associated with the mounted file system where 
the argument name resides. (As a special case, both the block device name and 
the swap device name are printed for the argument name / if swapping is done 
on the same disk section as the root file system.) Argument names must be full 
path names. 

This command is most commonly used by /etc/rc (see 6rc(lM)) to construct a 
mount table entry for the root device. 

EXAMPLE 

The command: 

/etc/devnm /usr 
produces 

dsk/Osl /usr 

if /usr is mounted on /dev/dsk/Osl. 

FILES 

/dev/dsk/* 

/etc/mnttab 

SEE ALSO 

brc(lM), setmnt(lM). 


- 1 - 



DF(1M) 


DF(1M) 


NAME 

df — report number of free disk blocks 
SYNOPSIS 

df [ — t ] [ -f ] [ file-systems 1 
DESCRIPTION 

Df prints out the number of free blocks and free i-nodes available for on-line 
file systems by examining the counts kept in the super-blocks; file-systems may 
be specified either by device name (e.g., /dev/dsk/Osl) or by mounted directory 
name (e.g., /usr). If the file-systems argument is unspecified, the free space 
on all of the mounted file systems is printed. 

The -t flag causes the total allocated block figures to be reported as well. 

If the -f flag is given, only an actual count of the blocks in the free list is 
made (free i-nodes are not reported). With this option, df will report on raw 
devices. 

FILES 

/dev/dsk/* 

/etc/mnttab 

SEE ALSO 

fs(4), mnttab(4). 
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DISKUSG ( 1M) 


DISKUSG (1M) 


NAME 

diskusg - generate disk accounting data by user ID 
SYNOPSIS 

diskusg [options] [files] 

DESCRIPTION 

Diskusg generates intermediate disk accounting information from data in files, 
or the standard input if omitted. Diskusg output lines on the standard output, 
one per user, in the following format: 

uid login ttblocks 

where 

uid - the numerical user ID of the user. 

login - the login name of the user; and 

#blocks - the total number of disk blocks allocated to this user. 

Diskusg normally reads only the i-nodes of file systems for disk accounting. In 
this case, files are the special filenames of these devices. 

Diskusg recognizes the following options: 

-s the input data is already in diskusg output format. Diskusg com- 

bines all lines for a single user into a single line. 

-v verbose. Print a list on standard error of all files that are charged 

to no one. 

-i fnmlist ignore the data on those file systems whose file system name is in 
fnmlist. Fnmlist is a list of file system names separated by com- 
mas or enclosed within quotes. Diskusg compares each name in 
this list with the file system name stored in the volume ID (see 
labelit(lM)). 

-p file use file as the name of the password file to generate login names, 

/etc/passwd is used by default. 

-u file write records to file of files that are charged to no one. Records 

consist of the special file name, the i-node number, and the user 
ID. 

The output of diskusg is normally the input to acctdisk (see acct (1M)) which 
generates total accounting records that can be merged with other accounting 
records. Diskusg is normally run in dodisk (see acctsh (1 M)). 

EXAMPLES 

The following will generate daily disk accounting information: 

for i in /dev/rpOO /dev/rpOl /dev/rplO /dev/rpll; do 
diskusg $i > dtmp.'basename $i‘ & 

done 

wait 

diskusg -s dtmp.* | sort +0n +1 | acctdisk > disktacct 

FILES 

/etc/passwd used for user ID to log in name conversions 

SEE ALSO 

acct(lM), acctsh (1M), acct (4). 
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DMKSET(IM) 


(DEC only) 


DMKSET(IM) 


NAME 

dmkset — connect DM11-BA modem control multiplexers to KMC11-B 
microprocessors 

SYNOPSIS 

/etc/dmkset [ — d ] dmkname kmcname 
DESCRIPTION 

The dmkset command provides a means for associating a DM11 -BA modem 
control multiplexer with a KMC11-B microprocessor. Dmkname is the DM 11 -BA 
device name and kmcname is the KMC11-B device name. A DM11-BA should 
only be associated to a KMC11-B that is used to control the DMS11-DA 8-line 
synchronous communications multiplexer that is physically connected to the 
same distribution panel as the DM 11 -BA. If the link-level (level 2) VPM 
software running in a KMC11-B requires the association, then it must be done 
prior to the first open for reading and/or writing of the VPM minor device. 

The — d option disconnects the DM 11 -BA from the KMC11-B. 

SEE ALSO 

vpmset(lM), dmk(7), vpm(7). 
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ERRDEAD (1M) 


ERRDEAD(lM) 


NAME 

errdead — extract error records from dump 
SYNOPSIS 

/etc/errdead dumpfile [ namelist ] 

DESCRIPTION 

When hardware errors are detected by the system, an error record that contains 
information pertinent to the error is generated. If the error-logging daemon 
errdemon (1M) is not active or if the system crashes before the record can be 
placed in the error file, the error information is held by the system in a local 
buffer. Errdead examines a system dump (or memory), extracts such error 
records, and passes them to errpt(lM) for analysis. 

The dumpfile specifies the file (or memory) that is to be examined. The sys- 
tem namelist is specified by namelist; if not given, /unix is used. 

FILES 

/unix system namelist 

/usr/bin/errpt analysis program 

/usr/tmp/errXXXXXX temporary file 

DIAGNOSTICS 

Diagnostics may come from either errdead or errpt. In either case, they are 
intended to be self-explanatory. 

SEE ALSO 

errdemon(lM), errpt(lM). 
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ERRDEMON(IM) 


ERRDEMON (1M) 


NAME 

errdemon — error-logging daemon 
SYNOPSIS 

/usr/lib/errdemon [ file ] 

DESCRIPTION 

The error-logging daemon errdemon collects error records from the operating 
system by reading the special file /dev/error and places them in file. If file is 
not specified when the daemon is activated, /usr/adm/errfile is used. Note that 
file is created if it does not exist; otherwise, error records are appended to it, so 
that no previous error data is lost. No analysis of the error records is done by 
errdemon ; that responsibility is left to errpt{\M). The error-logging daemon is 
terminated by sending it a software kill signal (see kill(\)). Only the super- 
user may start the daemon, and only one daemon may be active at any time. 

FILES 

/dev/error source of error records 

/usr/adm/errfile repository for error records 

DIAGNOSTICS 

The diagnostics produced by errdemon are intended to be self-explanatory. 

SEE ALSO 

errpt(lM), errstop(lM), kill ( 1 ) , err(7). 
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ERRPT(IM) 


ERRPT(IM) 


NAME 

errpt — process a report of logged errors 
SYNOPSIS 

errpt [ options ] [ files ] 

DESCRIPTION 

Errpt processes data collected by the error logging mechanism 
(errdemonl 1M)) and generates a report of that data. The default report is a 
summary of all errors posted in the files named. Options apply to all files and 
are described below. If no files are specified, errpt attempts to use 
/usr/adm/errfile as file. 

A summary report notes the options that may limit its completeness, records 
the time stamped on the earliest and latest errors encountered, and gives the 
total number of errors of one or more types. Each device summary contains 
the total number of unrecovered errors, recovered errors, errors unable to be 
logged, I/O operations on the device, and miscellaneous activities that occurred 
on the device. The number of times that errpt has difficulty reading input data 
is included as read errors. 


Any detailed report contains, in addition to specific error information, all 
instances of the error logging process being started and stopped, and any time 
changes (via datei 1)) that took place during the interval being processed. A 
summary of each error type included in the report is appended to a detailed 
report. 

A report may be limited to certain records in the following ways: 

— s date Ignore all records posted earlier than date, where date has 

the form mmddhhmmyy , consistent in meaning with the 
datei. 1) command. 

— e date Ignore all records posted later than date, whose form is as 

described above. 


—a 

— d devlist 


-p n 
-f 


Produce a detailed report that includes all error types. 

A detailed report is limited to data about devices given in 
devlist, where devlist can be one of two forms: a list of dev- 
ice identifiers separated from one another by a comma, or a 
list of device identifiers enclosed in double quotes and 
separated from one another by a comma and/or more spaces. 
Errpt is familiar with the common form of identifiers (e.g., 
rs03, RS04, hs; see Section 7 of this volume). For the 3B 20 
computer the devices for which errors are logged are DFC, 
IOP, and MT. For Digital Equipment Corporation machines, 
the (block) devices for which errors are logged are RP03, 
RP04, RP05, RP06, RP07, RS03, RS04, TS11, TU10, TU16, 
TU78, RK05, RK06, RK07, RM05, RM80, and RFll. Addi- 
tional identifiers are int and mem which include detailed 
reports of stray-interrupt and memory-parity type errors, 
respectively. 

Limit the size of a detailed report to n pages. 

In a detailed report, limit the reporting of block device errors 
to unrecovered errors. 


FILES 

/usr/adm/errfile default error file 
SEE ALSO 

date(l), errdead(IM), errdemon(lM), errfile(4). 
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FF(1M) 


(not on PDP-1 1 ) 


FF(1M) 


NAME 

ff — list file names and statistics for a file system 
SYNOPSIS 

/etc/ff [options] special 
DESCRIPTION 

Ff reads the i-list and directories of the special file, assuming it to be a file sys- 
tem, saving i-node data for files which match the selection criteria. Output 
consists of the path name for each saved i-node, plus any other file information 
requested using the print options below. Output fields are positional. The out- 
put is produced in i-node order; fields are separated by tabs. The default line 
produced by ff is: 

path-name i-number 

With all options enabled, output fields would be: 
path-name i-number size uid 

The argument n in the option descriptions that follow is used as a decimal 
integer (optionally signed), where +n means more than «, — n means less than 
n, and n means exactly n. A day is defined as a 24-hour period. 

— I Do not print the i-node number after each path name. 

—1 Generate a supplementary list of all path names for multiply 

linked files. 

— p prefix The specified prefix will be added to each generated path name. 

The default is .. 


— s Print the file size, in bytes, after each path name. 

— u Print the owner’s login name after each path name. 

—an Select if the i-node has been accessed in n days. 

— m n Select if the i-node has been modified in « days. 

— c rt Select if the i-node has been changed in n days. 

— n file Select if the i-node has been modified more recently than the 

argument file. 

— i i-node-list 

Generate names for only those i-nodes specified in i-node-list. 


EXAMPLES 

To generate a list of the names of all files on a specified file system: 


ff —I /dev/diskroot 

To produce an index of files and i-numbers which are on a file system and have 
been modified in the last 24 hours: 


ff — m —1 /dev/diskusr > /log/incbackup/usr/tuesday 
To obtain the path names for i-nodes 451 and 76 on a specified file system: 

ff — i 451,76 /dev/rdsk/0s7 
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FILESAVE(IM) 


FILESAVE(IM) 


NAME 

filesave, tapesave — daily/weekly UNIX system file system backup 

SYNOPSIS 

/etc /filesave.? 

/etc/tapesave 

DESCRIPTION 

These shell scripts are provided as models. They are designed to provide a sim- 
ple, interactive operator environment for file backup. Filesave.? is for daily 
disk-to-disk backup and tapesave is for weekly disk-to-tape. 

The suffix .? can be used to name another system where two (or more) 
machines share disk drives (or tape drives) and one or the other of the systems 
is used to perform backup on both. 

SEE ALSO 

shutdown (1M), volcopy(lM). 
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FORMAT(IM) (VAX stand-alone only) FORMAT(lM) 

NAME 

format — format and/or check RP06 and RM05 disk packs 
DESCRIPTION 

Format will format new RP06 or RM05 packs and check used packs (with write 
inhibited). The program reports the location and type of errors encountered, 
including ECC correctable error burst sizes. 

EXECUTION 

The following example shows how to load format on a VAX- 11/780 with a 
UNIX system updated floppy disc: 

»>r> 

HALTED AT nnnnnnnn 

»>B<cr> 

CPU HALTED 

INIT SEQ DONE 

HALT INST EXECUTED 

HALTED AT nnnnnnnn 

LOAD DONE, nnnnnnnnn BYTES LOADED 

$$ 

To execute format, type /stand/format after the stand-alone shell prompt $$. 
The formatter will print out its command vocabulary, and proceed inter- 
actively. If one wishes to format a pack on disk drive 1, for example, the com- 
mand is dlf. The program will double-check format requests, as pack contents 
will be destroyed. 

COMMANDS 

m n MBA with drive doing the format is n. (defaults to 0) 

d n drive with the pack to be formatted or checked is n. (drive number 

must be between 1 and 7) 
f format pack 

c check pack format 

q quit 

v print vocabulary 

R n set the error report level to n. 

X will tell you about the available report levels. 

The X command will explain the Report Level options the first time it is exe- 
cuted. Subsequent execution by the operator or by the program during error 
logging, will merely print the information defined by the current report level. 

FILES 

/stand/format 

SEE ALSO 

780ops(8). 
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NAME 

fsck, dfsck - file system consistency check and interactive repair 
SYNOPSIS 

/etc/fsck [-y] [-n] [ -sX] [ -SX] [ -t file] [ — q] [ -D] [ -f] [file- 
systems ] 

/etc/dfsck [ options 1 ] filsysl ... - [ options2 ] filsys2 ... 

DESCRIPTION 

Fsck 

Fsck audits and interactively repairs inconsistent conditions for UNIX system 
files. If the file system is consistent then the number of files, number of blocks 
used, and number of blocks free are reported. If the file system is inconsistent 
the operator is prompted for concurrence before each correction is attempted. 
It should be noted that most corrective actions will result in some loss of data. 
The amount and severity of data lost may be determined from the diagnostic 
output. The default action for each consistency correction is to wait for the 
operator to respond yes or no. If the operator does not have write permission 
fsck will default to a — n action. 

Fsck has more consistency checks than its predecessors check, dcheck, /check, 
and icheck combined. 

The following options are interpreted by fsck. 

— y Assume a yes response to all questions asked by fsck. 

-n Assume a no response to all questions asked by fsck', do not open the file 
system for writing. 

-sX Ignore the actual free list and (unconditionally) reconstruct a new one 
by rewriting the super-block of the file system. The file system should be 
unmounted while this is done; if this is not possible, care should be taken 
that the system is quiescent and that it is rebooted immediately after- 
wards. This precaution is necessary so that the old, bad, in-core copy of 
the superblock will not continue to be used, or written on the file system. 

The — sA option allows for creating an optimal free-list organization. 
The following forms of X are supported for the following devices: 

— s3 (RP03) 

— s4 (RP04, RP05, RP06) 

— sBlocks-per-cylinder:Blocks-to-skip (for anything else) 

If X is not given, the values used when the file system was created are 
used. If these values were not specified, then the value 400:7 is used. 

— SX Conditionally reconstruct the free list. This option is like —sX above 
except that the free list is rebuilt only if there were no discrepancies 
discovered in the file system. Using -S will force a no response to all 
questions asked by fsck. This option is useful for forcing free list reor- 
ganization on uncontaminated file systems. 

-t If fsck cannot obtain enough memory to keep its tables, it uses a scratch 
file. If the -t option is specified, the file named in the next argument is 
used as the scratch file, if needed. Without the -t flag , fsck will prompt 
the operator for the name of the scratch file. The file chosen should not 
be on the file system being checked, and if it is not a special file or did 
not already exist, it is removed when fsck completes. 

— q Quiet fsck. Do not print size-check messages in Phase 1. Unreferenced 

fifos will silently be removed. If fsck requires it, counts in the superblock 
will be automatically fixed and the free list salvaged. 


- 1 - 



- z - 


313 jjsqs yosfp Suiziunjdo jjBqssqs/sjs/ 

qssqs 0 } suisjsXs sjy jo jsij jjnBjsp sujbjuos jsjiqssqs/sjs/ 

saiu 

•uisjsXs 3[q iooj sqj qssqs oj yssfp ssn jou oq 

(dnojS uisjsXs 3jy puosss jo jsjy sqj 
0} sjsjsj jsmsue sqj jBqj SuijBsipuj) i b jo i b qjiM 3Suods3j sqj xysjd jsnui 
JojBJsdo sqj ‘yosfp uiojj uoijssnb b Suijsmsue usq^ -JojBJsdo sqj oj sSbsssui 
qsBS joj 3uiBu uisjsXs 3|g sqj juud jjim yosfp ‘siqj ui piB ox souo jb suibjS 
-ojd (PMI)^3J/ OMJ qi|M JSBJSJU! OJ JOJEJSdO UB SJIUUSd UIBjSojd yosfp 3qx 

sdnojS uisjsXs 3jy sqj ussMjsq jojBJBdss sqj si — y suisjsXs 
sjy jo sjss omj sqi joj yosf oj suoijdo ssBd oj pssn sjb zsuopdo puB jsuoijdo 
X|sno3UBqnujis ssAjjp jusjsjjip omj uo sqssqs uisjsXs s[y omj smojjb yosf(j 

’PSJCI 

•uisjsXs s]y iooj sqj jnq Suiqj 
-Xjsas qjiM pssn 3q pjnoqs puB jsjsej sXeaijb jsoui|b si ssiAsp mbj sqj Suiq33q3 

• (psjns 

-3X3 SI yosf 3J0J3q) UISqj SUIAOUISJ USqj puB ‘XjOJSSJlp Sqj 0} S3|IJ jo jsquinu 
b guiXdos ‘punoj+jso| SuiqBui Xq psqsijduiossB si siqx spBui sq ubo ssijjus 
qoiqM ui sjo[s Xjduis 3ABq jsnui puB ps>jssqs Suisq uisjsXs s|y sqj jo jooj sqj 
ui jsixssjd jsnui punoj+ jso| Xjojssjip sqj jBqj si uoijsijjssj Xjuo sqx Jsquinu 
SpOU-l 3qj SI pSUglSSB 3UIBU 3qX S3IJ0J33JIP XjdlUSUOU JO U0IJ3SUU0SSJ 3qj 
33J0J jjim yosj -uisqj saouisj Xjjus|is jjiav yosf ‘Xjduis si jj j[ you jo Xjduis si 
Xjojssjip jo 3|y sqj ji psyijou sq ijim jssn sqx Xjduisuou sjb S3|y sqj ji ‘Xjoj 
- 33Jip punoj+ jso| aqj ui uisqj Supujd Xq psjosuuossj ‘ssusjjnsuos s,JOjBJsdo 
sqj qjiAv ‘sjb (pssusjsjsjun jnq psjBSOjjB) ssijojssjip pus ss[y psuBqdjQ 


jssjjosuj junos spou-i ssjj jo/puB Jjsojq ssjj |Bjox 01 
jbuijoj jsij jjsojq ssjj pug '6 

uisjsXs sjy sqj ui sjb sjsqj UBqj sspou-i joj sqsojq sjoj\ 

sspou-i 9£gS9 UBqj sjop\j 

:s5jssqs Jjsojg jsdng g 

sSubj jo jno jsquinu spou-j 
spou-i psjBooj|Eun oj Suijuiod sjij 

:sqssqs Xjojssjiq •/_ 

sjsqMXuB joj psjunossB jou sqsojg g 

■jbuijoj spou-i pBg -g 

psuSijB sjXq- 9 j jou szis Xjojssjiq 

sqsojq jo jsquinu jssjjosuj 

:sqosqs szig -p 

•sjunos jjuij jssjjosuj •£ 

■uisjsXs sjy sqj 

jo sSubj sqj spisjno jsij ssjj sqj jo spou-i ub Xq psuiiBp sqsojg j 

jsi[ ssjj sqj jo spou-i suo UBqj sjoui Xq psuiiBp sjjsojg j 


iSMoyoj sb sjb psjpsqs sspusjsisuosuj 
jsiiqssqs/sjs/ sjy sqj 

uiojj suisjsXs sjy jjnBjsp jo jsij b pBSj jjim yssf ‘psyissds sjb siuaisds-d]if ou jj 

■Xjbs 

-ssssu si ji ji (9 ssBqj) psjsnjjsuossj sq jjim jsij ssjj sqx (g ssEqj) 
jsij ssjj sqj 5jssqs puB (j ssuqj) sszis puB Jjsojq >jssq 3 -qssqs jsbj j— 

ssqsBJO uisjsXs jsjje jnjssfj sqsojq pBq joj ps>jssqs sjb ssijojssjiq q— 


(Wl)NDSd 


(WI)^DSJ 



FSCK(IM) 


FSCK(lM) 


SEE ALSO 

checkall(lM), clri(lM), ncheck(lM), checklist(4), fs (4) , crash(8). 

Setting Up the UNIX System in the UNIX System V Administrator Guide. 

BUGS 

I-node numbers for . and .. in each directory should be checked for validity. 
DIAGNOSTICS 

The diagnostics produced by fsck are intended to be self-explanatory. 
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NAME 

fsdb — file system debugger 
SYNOPSIS 

/etc/fsdb special [ — ] 

DESCRIPTION 

Fsdb can be used to patch up a damaged file system after a crash. It has 
conversions to translate block and i-numbers into their corresponding disk 
addresses. Also included are mnemonic offsets to access different parts of an i- 
node. These greatly simplify the process of correcting control block entries or 
descending the file system tree. 

Fsdb contains several error-checking routines to verify i-node and block 
addresses. These can be disabled if necessary by invoking fsdb with the 
optional — argument or by the use of the O symbol. ( Fsdb reads the i-size and 
f-size entries from the superblock of the file system as the basis for these 
checks.) 

Numbers are considered decimal by default. Octal numbers must be prefixed 
with a zero. During any assignment operation, numbers are checked for a pos- 
sible truncation error due to a size mismatch between source and destination. 

Fsdb reads a block at a time and will therefore work with raw as well as block 
I/O. A buffer management routine is used to retain commonly used blocks of 
data in order to reduce the number of read system calls. All assignment opera- 
tions result in an immediate write-through of the corresponding block. 

The symbols recognized by fsdb are: 

# absolute address 

i convert from i-number to i-node address 

b convert to block address 

d directory slot offset 

+,— address arithmetic 

q quit 

> , < save, restore an address 

= numerical assignment 

= + incremental assignment 

= — decremental assignment 

= " character string assignment 

O error-checking flip flop 

p general print facilities 

f file print facility 

B byte mode 

W word mode 

D double word mode 

! escape to shell 

The print facilities generate a formatted output in various styles. The current 
address is normalized to an appropriate boundary before printing begins. It 
advances with the printing and is left at the address of the last item printed. 
The output can be terminated at any time by typing the delete character. If a 
number follows the p symbol, that many entries are printed. A check is made 
to detect block boundary overflows since logically sequential blocks are gen- 
erally not physically sequential. If a count of zero is used, all entries to the end 
of the current block are printed. 
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2i.aOb.d7=3 


d7.nm="name" 


a2b.p0d 


changes the i-number for the seventh directory slot in the 
root directory to 3. This example also shows how several 
operations can be combined on one command line. 

changes the name field in the directory slot to the given 
string. Quotes are optional when used with nm if the first 
character is alphabetic. 

prints the third block of the current i-node as directory 
entries. 


SEE ALSO 

fsck(lM), dir (4) , fs(4). 


- 3 - 



- 1 - 


(j)Ibu8is ‘(z)hpi ‘(i)sd ‘(JMl)Junoui 

OS1V 3HS 

sSEUII UISJSXS JOJ OS|B UI0UI/A3P/ 

38buii uisjsXs joj uisuiq/Asp/ 

JSI|3UJEU joj xiun/ 

sana 

3UI| pUBUIUIOO SjSuiS B UI S3[dlUBX3 9AOqB 3qj JO qjOq op [|IA\ 

pMSSBd/ojo/ n— ^sj/qsp/Asp/ nq_ jssnj 

usdo 3|y pjOA\ 

-ssBd sqj SAEq jsqj sssssoojd jo ssuieu u;8o[ puB sai ssooojd jsq pi/A 

pMSSBd/ojo/ n— jssnj 

•p3JJI3J SI JI SB q3E3 JO 3UIBU UlSO[ 
puB ai sssoojd sqj Suijsq ‘J3sn-J3dns sqj Xq psdXj ji psjunouiun Suisq 

UIOJJ 3U0 SAIjp XJSip SUIJUSAOjd 3JB JEqj S3SS330id j|B SJBUIUIJSJ J]IM 

^SJ/qSp/ASp/ nq_ J3Snj 

saidwvxa 

•J0JJ3 pJBpUBJS 

uo usjjijm si jndjno jsqjo jjV 3U !I M3U 3 lSuis b qjiA\ psjBuiuusj puB ssoBds Xq 
psjBJEdss ‘jndjno pjBpuBjs oqj uo sup s|guis e sb psjuud sjb sai sssoojd sqx 

'33 JOJ UI X[;U3Jjn3 SUOIjdO XuB §UI[03UE0 qSBp SUO| B qjIA\ 

‘J3S PJO 3qi S33B|d3J SUOIjdO JO JSS A\3U 3qX S3[q JO sdnojg U33/A13q psyiDSdsSJ 
sq Xbui suopdo ' ((£) IIW 33S ) sssoojd s^jssn jsqjouB sjbuiuijsj ubo jssn 
-jsdns oqi Xjuo sssoojd qoso oj juss si jbuSis niMOIS sqj ‘psypsds si uopdo 
q— sqj ji ‘uoijippB uj ai sssoojd sqj SMoyoj os[B ‘ssssqjusjBd ui ‘suibu uiSoi 
sqj ‘psyiosds si uopdo n— sqj jj XjSAijosdssj ‘Xjojosjjp jooj sji jo ‘(uiojsXs sqj 
Xq ssn ui usqA\ Xjuo) Xjojosjip jusjjtio sp jo luojsd sqj ‘Xjojosjip jusjjtio sp 
sb sjy sqj Sujsn si sssoojd sqj ji j jo d fa Xq psMoqoj si qi sssoojd sqx 'psjsq 

3JB SOIASp JEqj UO 3jq XuB SUISTI S3SS330jd JJB ‘SSOIASp |BI3SdS qOO]q JOJ SJUSUI 

-ngjB sb poyioods sd\\f sqj 8uisn sssssoojd sqj jo sai sssoojd sqj sjsq uasn j 

MOiididDsaa 

[S3[g [nq— ]] [ - ] ssjy [nq_ ] jasnj/oja/ 

SISdONAS 

sjnjoiujs 3[ij jo 3|ij b Suisn sssssoojd Xjijuopi _ jssnj 

3WVN 


(jMi)aasaa 


(NDdasaa 



FWTMP(IM) 


FWTMP(IM) 


NAME 

fwtmp, wtmpfix — manipulate connect accounting records 
SYNOPSIS 

/usr/lib/acct/fwtmp [ — ic] 

/usr/lib/acct/wtmpfix [files] 

DESCRIPTION 

Fwtmp 

Fwtmp reads from the standard input and writes to the standard output, con- 
verting binary records of the type found in wtmp to formatted ASCII records. 
The ASCII version is useful to enable editing, via ed( 1), bad records or general 
purpose maintenance of the file. 

The argument — ic is used to denote that input is in ASCII form, and output is 
to be written in binary form. 

Wtmpfix 

Wtmpfix examines the standard input or named files in wtmp format, corrects 
the time/date stamps to make the entries consistent, and writes to the standard 
output. A - can be used in place of files to indicate the standard input. If 
time/date corrections are not performed, acctconl will fault when it encounters 
certain date-change records. 

Each time the date is set, a pair of date change records are written to 
/etc/wtmp. The first record is the old date denoted by the string old time 
placed in the line field and the flag OLD TIME placed in the type field of the 
<utmp.h> structure. The second record specifies the new date and is denoted 
by the string new time placed in the line field and the flag NEW_TIME placed in 
the type field. Wtmpfix uses these records to synchronize all time stamps in 
the file. 

In addition to correcting time/date stamps, wtmpfix will check the validity of 
the name field to ensure that it consists solely of alphanumeric characters or 
spaces. If it encounters a name that is considered invalid, it will change the 
login name to INVALID and write a diagnostic to the standard error. In this 
way, wtmpfix reduces the chance that acctconl will fail when processing con- 
nect accounting records. 

FILES 

/etc/wtmp 
/usr/include/ utmp.h 

SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), 
acctprc(lM), acctsh(lM), runacct(lM), ed ( 1 ) , acct(2), acct(4), utmp(4). 
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The user’s name is scanned to see if it contains any lower-case alphabetic char- 
acters; if not, and if the name is non-empty, the system is told to map any 
future upper-case characters into the corresponding lower-case characters. 

Finally, login is called with the user’s name as an argument. Additional argu- 
ments may be typed after the login name. These are passed to login, which 
will place them in the environment (see logini. 1)). 

A check option is provided. When getty is invoked with the — c option and file, 
it scans the file as if it were scanning /etc/gettydefs and prints out the results 
to the standard output. If there are any unrecognized modes or improperly 
constructed entries, it reports these. If the entries are correct, it prints out the 
values of the various flags. See ioctl{ 2) to interpret the values. Note that 
some values are added to the flags automatically. 

FILES 

/etc/gettydefs 

/etc/issue 

SEE ALSO 

ct(lC), init(lM), login(l), ioctl (2) , gettydefs(4), inittab (4) , tty (7). 

BUGS 

While getty does understand simple single character quoting conventions, it is 
not possible to quote the special control characters that getty uses to determine 
when the end of the line has been reached, which protocol is being used, and 
what the erase character is. Therefore, it is not possible to log in via getty and 
type a #, @, /, !, _, backspace, A U, A D, or & as part of your login name or 
arguments. They will always be interpreted as having their special meaning as 
described above. 
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If a 0 through 6 is entered init enters the corresponding run-level. Any other 
input will be rejected and the user will be re-prompted. If this is the first time 
init has entered a run-level other than SINGLE USER , init first scans inittab for 
special entries of the type boot and bootwait. These entries are performed, 
providing the run-level entered matches that of the entry before any normal 
processing of inittab takes place. In this way any special initialization of the 
operating system, such as mounting file systems, can take place before users are 
allowed onto the system. The inittab file is scanned to find all entries that are 
to be processed for that run-level. 

Run-level 2 is usually defined by the user to contain all of the terminal 
processes and daemons that are spawned in the multi-user environment. 

In a multi-user environment, the inittab file is usually set up so that init will 
create a process for each terminal on the system. 

For terminal processes, ultimately the shell will terminate because of an end- 
of-file either typed explicitly or generated as the result of hanging up. When 
init receives a child death signal, telling it that a process it spawned has died, it 
records the fact and the reason it died in /etc/utmp and /etc/wtmp if it exists 
(see wJio(l)). A history of the processes spawned is kept in /etc/wtmp if such 
a file exists. 

To spawn each process in the inittab file, init reads each entry and for each 
entry which should be respawned, it forks a child process. After it has spawned 
all of the processes specified by the inittab file, init waits for one of its descen- 
dant processes to die, a powerfail signal, or until init is signaled by init or tel- 
init to change the system’s run-level. When one of the above three conditions 
occurs, init re-examines the inittab file. New entries can be added to the init- 
tab file at any time; however, init still waits for one of the above three condi- 
tions to occur. To provide for an instantaneous response the init Q or init q 
command can wake init to re-examine the inittab file. 

If init receives a powerfail signal ( SIGPWR ) and is not in SINGLE USER mode, 
it scans inittab for special powerfail entries. These entries are invoked (if the 
run-levels permit) before any further processing takes place. In this way init 
can perform various cleanup and recording functions whenever the operating 
system experiences a power failure. 

When init is requested to change run-levels (via telinit ) , init sends the warning 
signal (SIGTERM) to all processes that are undefined in the target run-level. 
Init waits 20 seconds before forcibly terminating these processes via the kill sig- 
nal (SIGKILL). 


Telinit 

Telinit , which is linked to / etclinit , is used to direct the actions of init. It takes 
a one-character argument and signals init via the kill system call to perform 
the appropriate action. The following arguments serve as directives to init. 

0-6 tells init to place the system in one of the run-levels 0-6. 

a,b,c tells init to process only those /etc/inittab file entries having 

the a, b or c run-level set. 

Q,q tells init to re-examine the /etc/inittab file. 

s,S tells init to enter the single user environment. When this 

level change is effected, the virtual system teletype, 
/dev/syscon, is changed to the terminal from which the com- 
mand was executed. 


Telinit can only be run by someone who is super-user or a member of group 
sys. 
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NAME 

install — install commands 
SYNOPSIS 

/etc/install [-c dira] [ -f dirb] [ — i] [ -n dire] [- 0 ] [ -s] file [dirx ...] 
DESCRIPTION 

Install is a command most commonly used in “makefiles” (see make{ 1)) to 
install a file (updated target file) in a specific place within a file system. Each 
file is installed by copying it into the appropriate directory, thereby retaining 
the mode and owner of the original command. The program prints messages 
telling the user exactly what files it is replacing or creating and where they are 
going. 

If no options or directories ( dirx ...) are given, install will search a set of 
default directories (/bin, /usr/bin, /etc, /lib, and /usr/lib, in that order) for a 
file with the same name as file. When the first occurrence is found, install 
issues a message saying that it is overwriting that file with file, and proceeds to 
do so. If the file is not found, the program states this and exits without further 
action. 

If one or more directories {dirx ...) are specified after file, those directories 
will be searched before the directories specified in the default list. 

The meanings of the options are: 

— c dira Installs a new command {file) in the directory specified 

by dira, only if it is not found. If it is found, install 
issues a message saying that the file already exists, and 
exits without overwriting it. May be used alone or with 
the — s option. 

— f dirb Forces file to be installed in given directory, whether or 

not one already exists. If the file being installed does 
not already exist, the mode and owner of the new file 
will be set to 755 and bin, respectively. If the file 
already exists, the mode and owner will be that of the 
already existing file. May be used alone or with the — o 
or — s options. 

— i Ignores default directory list, searching only through the 

given directories {dirx ...). May be used alone or with 
any other options except — c and — f. 

— n dire If file is not found in any of the searched directories, it 

is put in the directory specified in dire. The mode and 
owner of the new file will be set to 755 and bin, respec- 
tively. May be used alone or with any other options 
other than — c and — f. 

— o If file is found, this option saves the “found” file by 

copying it to OLD file in the directory in which it was 
found. This option is useful when installing a normally 
text busy file such as /bin/sh or /etc/getty, where the 
existing file cannot be removed. May be used alone or 
with any other options other than — c. 

— s Suppresses printing of messages other than error mes- 

sages. May be used alone or with any other options. 

SEE ALSO 

cpset(lM), make(l), mk(8). 
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NAME 

link, unlink - exercise link and unlink system calls 

SYNOPSIS 

/etc/link filel file2 
/etc/unlink file 


DESCRIPTION 

Link and unlink perform their respective system calls on their arguments, 
abandoning all error checking. These commands may only be executed by the 
super-user, who (it is hoped) knows what he or she is doing. 


SEE ALSO 

rm(l), link(2), unlink(2). 


- 1 



- 1 - 


guiuunj st jajnpaqas 

aqi agqM pasn aq Asm uiwpvdj uaqj ‘paqddns ojb suopdo 
a- pun d- aqj Xiao jj jajuud auo uBqj ojoui qjiM aamap a uies 
aqi guijspossB uiojj jojBjjsiuiuipE ub dojs oj guiqjou si ajaqj 
l^qj ajojq d] ‘jojBjjsiuiuipE dq aqj Aq ajqBjuM si jEqj ajg b jo 
auiBu qjBd aqj si aaiAajj j jajuiid qjiM boia ap Mau b sbjbioossb aaiAdp\— 

paAouiaj aq qiM ssvp aqj uaqj ‘ssvp aqj jo jaquiaixi 
jsbi aqj si j ji ssvp paypads aqj uiojj j jajuud saaouiaj ssvpi- 

•(Mopq 

sppojM aas) bjbmjjos dl aqj qjiM paqddns sauiBu aoBjjajui |apoui 

aqj jo auo si ppopi j joj uiBjgojd aoBjjajui japoui b sjaaps ppoiuva- 

uiuipvdi guisn paqsqqnjsa aq ppioqs aatAap juajjna 
sq ‘j guqqBua-aj ajojag pajJBjs si q aunj qaBa AqBaijBUiojnB 
sjBuiuijaj u;So[ ][B sajqBsip ‘ (yi\) patjosd] ‘jajnpaqas dl aqx 
qBUiuuaj ui8o| b si j qjiM pajBiaossE aapap aqj jsqj sajBaipui [_ 

uiBjgojd Mau aqj jo auiBu 

qjBd aqj si aavpajuj j joj uiBjgojd aanjjajui Mau b saqsqqsjsa aavpajun- 

paqddns si uopdo 

I— aqi ssajun jajuud Mau b guijnaja uaqM pauinssB si uopdo 

s !*ll paJiMpjBq si j qjiM pajBiaossB aouap aqj jBqj sajBajpui q_ 

J JOJ UiBjgojd 3DBJ 

-jajui Mau aqj aq oj uiBjgojd aoBjjajui s jajuud guijsjxa ub saidoa jajuuda- 

jsixa ApBajjB jou saop ji 

ji pajBajo aq qiM ssvjj ssvp paijpads aqj ojui j jajuud sjjasui ssvpo- 

Mopq j se oj pajjajaj aq [jim jajuud aqj ‘uoissnasip jo asua joj 
japjo Xub ui JBaddB Abui puB d— qjiM [njasn Ajuo ajB suopdo guiMoqoj aqj^ 

pajBajo aq jjim ji uaqj jsixa jou saop jajuud 
JI uajaj Mopq suopdo aqj jo qB qaiqM oj jajuud b sauiBu jajuudA- 

x— qjiM paMO||B ajB suopdo jaqjo ojq ooj 
‘pajapp aq qiM ssBp aqj uaqj ‘sssp b jo jaquiaui A[uo aqj s; puB 
jajuud b si jsap jj uiajsAs dl aqj uiojj jsap uoijEuijsap soaouioj jsapx— 

p— qjjM paMO[|B ajB suopdo jaqjo ojsj guiu 
-unj si (IM J ) payasdj uaqM pasn aq Abui uoijdo siqx uoijEuijsap 
JinBjap uiajsAs ou si ajaqj uaqj ‘paqddns jou si jsap ji -uoyBu 
-ijsap jjnBjap uiajsAs Mau aqj ‘uoijEuijsap guijsixa ub ‘jsap saqnui [Jsap] p- 

•UlUjpvdj JO UOIJE3 

-oaui [Bga[ Ajoao joj juasajd aq jsnui suoijdo x— jo p— ‘d— aqj jo auo Ajjasxg 

Mopq pajou ajaqM jdaaxa ‘guiuunj si '(y^i)patjasdi ‘jajnpaqas 
dT aqj uaqM pasn aq jou Abui ujiupvdp -uoijEuijsap qnBjap uiajsAs aqj 
agunqa oj pus suiBjgojd aoBjjajui jajuud aguBqa ‘sjajuud joj saaiAap aguBqa 
‘sassBp ui diqsjaquiaui aguBqa ‘suoijBuqsap aAouiaj pus ppB oj pasn si jj -saai 
-Aap puB sassBp ‘sjajuud aquasap oj suiajsAs guqoods dl sajngguoa uiwpvdj 

NOUdl^DSHa 
[jsap]p_ ujuipBd|/qq/jsn/ 
jsapx— uiuipBd|/qq/jsn/ 
[suopdo] jajuud d— u;uipBdi/qi|/Jsn/ 

SISdONAS 

uiajsAs guqoods dl oqi ajngquoa — uiuipBdj 

HWVN 


(wi)Niwavdi 


(wi)Niwavdi 



LPADMIN (1M) 


LPADMIN(IM) 


” Restrictions 

When creating a new printer, the — v option and one of the — e, — i or — m 
options must be supplied. Only one of the — e, — i or — m options may be sup- 
plied. The — h and —1 keyletters are mutually exclusive. Printer and class 
names may be no longer than 14 characters and must consist entirely of the 
characters A-Z, a-z, 0-9 and _ (underscore). 

Models 

Model printer interface programs are supplied with the LP software. They are 
shell procedures which interface between Ipsched (1M) and devices. All 
models reside in the directory /usr/spool/lp/model and may be used as is with 
Ipadmin — m. Models should have 644 permission if owned by lp & bin, or 664 
permission if owned by bin & bin. Alternatively, LP administrators may 
modify copies of models and then use Ipadmin — i to associate them with 
printers. The following list describes the models and lists the options which 
they may be given on the Ip command line using the — o keyletter: 

dumb interface for a line printer without special functions and protocol. 
Form feeds are assumed. This is a good model to copy and modify for 
printers which do not have models. 

1640 DIABLO 1640 terminal running at 1200 baud, using XON/XOFF proto- 
col. Options: 

— 12 12-pitch (10-pitch is the default) 

— f do not use the 450(1) filter. The output has been pre- 

processed by either 450(1) or the nroff (1) 450 driving table. 

hp Hewlett-Packard 2631 A line printer at 2400 baud. Options: 

— c compressed print 

— e expanded print 

prx Printronix P300 or P600 printer using XON/XOFF protocol at 1200 
baud. 

EXAMPLES 

1. Assuming there is an existing Hewlett-Packard 2631 A line printer named 
hp2, it will use the hp model interface after the command: 

/usr/lib/lpadmin — php2 — mhp 

2. To obtain compressed print on hp2 , use the command: 

lp — dhp2 — o— c files 

3. A DIABLO 1640 printer called stl can be added to the LP configuration 
with the command: 

/usr/lib/lpadmin — pstl — v/dev/tty20 — ml 640 

4. An nroff (1) document may be printed on stl in any of the following ways: 

nroff — T450 files | lp — dstl —of 
nroff — T450— 12 files | lp —dstl —of 
nroff — ' T37 files | col | lp —dstl 

5. The following command prints the password file on stl in 12-pitch: 

lp —dstl — ol2 /etc/passwd 

NOTE: the —12 option to the 1640 model should never be used in conjunc- 
tion with nroff (1). 
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NAME 

lpsched, lpshut, lpmove — start/stop the LP request scheduler and move 
requests 

SYNOPSIS 

/usr/lib/lpsched 

/usr/Iib/Ipshut 

/usr/lib/lpmove requests dest 
/usr/Iib/lpmove dest I dest2 

DESCRIPTION 

Lpsched schedules requests taken by lp( 1) for printing on line printers. 

Lpshut shuts down the line printer scheduler. All printers that are printing at 
the time lpshut is invoked will stop printing. Requests that were printing at 
the time a printer was shut down will be reprinted in their entirety after 
lpsched is started again. All LP commands perform their functions even when 
lpsched is not running. 

Lpmove moves requests that were queued by lp{ 1) between LP destinations. 
This command may be used only when lpsched is not running. 

The first form of the command moves the named requests to the LP destination, 
dest. Requests are request ids as returned by lp{ 1). The second form moves 
all requests for destination destl to destination dest 2. As a side effect, Ip (l) 
will reject requests for destl . 

Note that lpmove never checks the acceptance status (see accept (1M)) for the 
new destination when moving requests. 

FILES 

/usr/spool/lp/* 

SEE ALSO 

accept (1M), enable(l), lp(l), lpadmin(IM), lpstat(l). 
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NAME 

mkfs — construct a file system 
SYNOPSIS 

/etc/mkfs special blocks[:i-nodes] [gap blocks/cyl] 

/etc/mkfs special proto [gap blocks/cyl] 

DESCRIPTION 

Mkfs constructs a file system by writing on the special file according to the 
directions found in the remainder of the command line. The command waits 
10 seconds before starting to construct the file system. If the second argument 
is given as a string of digits, mkfs builds a file system with a single empty 
directory on it. The size of the file system is the value of blocks interpreted as 
a decimal number. This is the number of physical disk blocks the file system 
will occupy. The boot program is left uninitialized. If the optional number of 
i-nodes is not given, the default is the number of logical blocks divided by 4. 

If the second argument is a file name that can be opened, mkfs assumes it to 
be a prototype file proto , and will take its directions from that file. The proto- 
type file contains tokens separated by spaces or new-lines. The first token is the 
name of a file to be copied onto block zero as the bootstrap program (see 
3B20boot(, 8) or unixbootl 8)). The second token is a number specifying the 
size of the created file system in physical disk blocks. Typically it will be the 
number of blocks on the device, perhaps diminished by space for swapping. 
The next token is the number of i-nodes in the file system. The maximum 
number of i-nodes configurable is 65500. The next set of tokens comprise the 
specification for the root file. File specifications consist of tokens giving the 
mode, the user ID, the group ID, and the initial contents of the file. The syntax 
of the contents field depends on the mode. 

The mode token for a file is a 6-character string. The first character specifies 
the type of the file. (The characters —bed specify regular, block special, char- 
acter special and directory files respectively.) The second character of the type 
is either u or — to specify set-user-id mode or not. The third is g or — for the 
set-group-id mode. The rest of the mode is a 3 digit octal number giving the 
owner, group, and other read, write, execute permissions (see chmodll)) . 

Two decimal number tokens come after the mode; they specify the user and 
group IDs of the owner of the file. 

If the file is a regular file, the next token is a path name whence the contents 
and size are copied. If the file is a block or character special file, two decimal 
number tokens follow which give the major and minor device numbers. If the 
file is a directory, mkfs makes the entries . and .. and then reads a list of 
names and (recursively) files specifications for the entries in the directory. The 
scan is terminated with the token $. 

A sample prototype specification follows; 

/stand /diskboot 
4872 110 

d 111 3 1 

usr d 111 3 1 

sh 755 3 1 /bin/sh 

ken d — 755 6 1 

$ 

bO b — 644 3 1 0 0 

cO c — 644 3 1 0 0 

$ 

$ 
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NAME 

mknod — build special file 
SYNOPSIS 

( /etc/mknod name c | b major minor 
/etc/mknod name p 

DESCRIPTION 

Mknod makes a directory entry and corresponding i-node for a special file. 
The first argument is the name of the entry. In the first case, the second is b if 
the special file is block-type (disks, tape) or c if it is character-type (other dev- 
ices). The last two arguments are numbers specifying the major device type 
and the minor device (e.g., unit, drive, or line number), which may be either 
decimal or octal. 

The assignment of major device numbers is specific to each system. They have 
to be dug out of the system source file conf.c. 

Mknod can also be used to create fifo’s (a.k.a named pipes) (second case in 
SYNOPSIS above). 

SEE ALSO 

mknod (2). 
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NAME 

mvdir — move a directory 
SYNOPSIS 

/etc/mvdir dirname name 
DESCRIPTION 

Mvdir moves directories within a file system. Dirname must be a directory; 
name must not exist. Neither name may be a sub-set of the other (/x/y can- 
not be moved to /x/y/z, nor vice versa). 

Only super-user can use mvdir. 

SEE ALSO 

mkdir(l). 
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NAME 

pcldaemon — PCL link monitor 

SYNOPSIS 

/usr/lib/ pcldaemon 

DESCRIPTION 

Pcldaemon monitors the pcl(l) control channel, servicing requests as they 
arrive. Requests are transmitted via net (1C). 

FILES 

/dev/pcl/?[0-7] PCL channel interfaces for system ?. 

/dev/pcl/ctrl PCL control channel. 

/usr/adm/pcllog activity log. 

SEE ALSO 

net(lC), pcl(7). 

DIAGNOSTICS 

cannot open pci control channel 

Another pcldaemon is running. 

WARNINGS 

Running pcldaemon may present security hazards. A super-user may net (1C) 
to any system on the PCL bus that is running pcldaemon and execute any com- 
mand on that system. 
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NAME 

pwck, grpck — password/group file checkers 

SYNOPSIS 

/etc/pwck [file] 

/etc/grpck [file] 

DESCRIPTION 

Pwck scans the password file and notes any inconsistencies. The checks include 
validation of the number of fields, login name, user ID, group ID, and whether 
the login directory and optional program name exist. The criteria for determin- 
ing a valid login name is derived from Setting up the UNIX System in the 
UNIX System V Administrator Guide. The default password file is 
/etc/passwd. 

Grpck verifies all entries in the group file. This verification includes a check of 
the number of fields, group name, group ID, and whether all login names 
appear in the password file. The default group file is /etc/group. 

FILES 

/etc/group 

/etc/passwd 

SEE ALSO 

group (4), passwd(4). 

Setting Up the UNIX System in the UNIX System V Administrator Guide. 

DIAGNOSTICS 

Group entries in /etc/group with no login names are flagged. 
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NAME 

runacct — run daily accounting 
SYNOPSIS 

/usr/lib/acct/ runacct [mmdd [state]] 

DESCRIPTION 

Runacct is the main daily accounting shell procedure. It is normally initiated 
via croni 1M). Runacct processes connect, fee, disk, and process accounting 
files. It also prepares summary files for prdaily or billing purposes. 

Runacct takes care not to damage active accounting files or summary files in 
the event of errors. It records its progress by writing descriptive diagnostic 
messages into active. When an error is detected, a message is written to 
/dev/console, mail (see maili 1)) is sent to root and adm, and runacct ter- 
minates. Runacct uses a series of lock files to protect against re-invocation. 
The files lock and lockl are used to prevent simultaneous invocation, and last- 
date is used to prevent more than one invocation per day. 

Runacct breaks its processing into separate, restartable states using statefile to 
remember the last state completed. It accomplishes this by writing the state 
name into statefile. Runacct then looks in statefile to see what it has done and 
to determine what to process next. States are executed in the following order: 


SETUP 

WTMPFIX 

CONNECTl 

CONNECT2 

PROCESS 


Move active accounting files into working files. 

Verify integrity of wtmp file, correcting date changes 
if necessary. 

Produce connect session records in ctmp.h format. 
Convert ctmp.h records into tacct.h format. 

Convert process accounting records into tacct.h for- 
mat. 


MERGE 

FEES 

DISK 

MERGETACCT 


Merge the connect and process accounting records. 

Convert output of chargefee into tacct.h format and 
merge with connect and process accounting records. 

Merge disk accounting records with connect, process, 
and fee accounting records. 

Merge the daily total accounting records in daytacct 
with the summary total accounting records in 
/usr/adm/ acct/ sum/ tacct. 


CMS Produce command summaries. 

USEREXIT Any installation-dependent accounting programs can 

be included here. 


CLEANUP Cleanup temporary files and exit. 

To restart runacct after a failure, first check the active file for diagnostics, then 
fix up any corrupted data files such as pacct or wtmp. The lock files and last- 
date file must be removed before runacct can be restarted. The argument 
mmdd is necessary if runacct is being restarted, and specifies the month and 
day for which runacct will rerun the accounting. Entry point for processing is 
based on the contents of statefile; to override this, include the desired state on 
the command line to designate where processing should begin. 
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NAME 

sadp — disk access profiler 
SYNOPSIS 

sadp [ — th ] [ — d device! —drive] ] s [ n ] 

DESCRIPTION 

Sadp reports disk access location and seek distance, in tabular or histogram 
form. It samples disk activity once every second during an interval of s 
seconds. This is done repeatedly if n is specified. Cylinder usage and disk dis- 
tance are recorded in units of 8 cylinders. 

Valid values of device are rp06, rm05, and disk. Drive specifies the disk drives 
and it may be: 

a drive number in the range supported by device , 
two numbers separated by a minus (indicating an inclusive range), 
or 

a list of drive numbers separated by commas. 

Up to 8 disk drives may be reported. The — d option may be omitted, if only 
one device is present. 

The — t flag causes the data to be reported in tabular form. The — h flag pro- 
duces a histogram on the printer of the data. Default is — t. 

EXAMPLE 

The command: 

sadp — d rp06— 0 900 4 

will generate 4 tabular reports, each describing cylinder usage and seek dis- 
tance of rp06 disk drive 0 during a 15-minute interval. 

FILES 

/dev/kmem 
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The structure of the binary daily data file is: 
struct sa { 

struct sysinfo si; /* see /usr/ include/sys/ sysinfo.h */ 
int szi-node; /« current entries of i-node table */ 

int szfile; /* current entries of file table */ 

int sztext; /* current entries of text table */ 

int szproc; / * current entries of proc table */ 

int mszi-node; / * size of i-node table */ 

int mszfile; /* size of file table */ 

int msztext; /* size of text table */ 

int mszproc; /* size of proc table */ 

long i-nodeovf; /* cumul. overflows of i-node table */ 
long fileovf; /* cumul. overflows of file table */ 

long textovf; /* cumul. overflows of text table */ 

long procovf; /* cumul. overflows of proc table */ 

time t ts; /* time stamp, seconds */ 

long devio[NDEVS][4j; /* device info for up to NDEVS units */ 
#define IO_OPS 0 /* cumul. I/O requests */ 

#define IQJBCNT 1 /* cumul. blocks transferred */ 

#define IO_ACT 2 /* cumul. drive busy time in ticks */ 

#define IO_RESP 3 /* cumul. I/O resp time in ticks */ 

}; 

FILES 

/ usr/adm/sa/ sarfd daily data file 

/usr/adm/sa / sardd daily report file 

/tmp/sa.adrfl address file 

SEE ALSO 

cron(lM), sag(lG), sar(l), timex(l). 
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NAME 

shutdown — terminate all processing 

SYNOPSIS 

/etc /shutdown 

DESCRIPTION 

Shutdown is part of the UNIX system operation procedures. Its primary func- 
tion is to terminate all currently running processes in an orderly and cautious 
manner. The procedure is designed to interact with the operator (i.e., the per- 
son who invoked shutdown ) . Shutdown may instruct the operator to perform 
some specific tasks, or to supply certain responses before execution can resume. 
Shutdown goes through the following steps: 

All users logged on the system are notified to log off the system by a broad- 
casted message. The operator may display his/her own message at this time. 
Otherwise, the standard file-save message is displayed. 

If the operator wishes to run the file-save procedure, shutdown unmounts all 
file systems. 

All file systems’ super blocks are updated before the system is to be stopped 
(see sy/icO)). This must be done before re-booting the system, to insure 
file system integrity. The most common error diagnostic that will occur is 
device busy. This diagnostic happens when a particular file system could 
not be unmounted. 


SEE ALSO 

mount(lM), sync(l). 
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NAME 

tic — terminfo compiler 

SYNOPSIS 

tic [ — v[«] ] file ... 

DESCRIPTION 

Tic translates terminfo files from the source format into the compiled format. 
The results are placed in the directory / usr/lib/ terminfo. 

The —y (verbose) option causes tic to output trace information showing its pro- 
gress. If the optional integer is appended, the level of verbosity can be 
increased. 

Tic compiles all terminfo descriptions in the given files. When a use= field is 
discovered, tic searches first the current file, then the master file, which is 
“./terminfo.src”. 

If the environment variable TERMINFO is set, the results are placed there 
instead of / usr/lib/ terminfo. 

Some limitations: total compiled entries cannot exceed 4096 bytes. The name 
field cannot exceed 128 bytes. 

FILES 

/usr/lib/terminfo/*/* compiled terminal capability data base 
SEE ALSO 

curses(3X), terminfo(4). 

BUGS 

Instead of searching ./terminfo.src, it should check for an existing compiled 
entry. 
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NAME 

uusub — monitor uucp network 
SYNOPSIS 

/usr/lib/uucp/uusub [ options ] 

DESCRIPTION 

Uusub(lM) defines a uucp subnetwork and monitors the connection and traffic 
among the members of the subnetwork. The following options are available: 

— asys Add sys to the subnetwork. 

— di>>5 Delete sys from the subnetwork. 

—1 Report the statistics on connections. 

— r Report the statistics on traffic amount. 

— f Flush the connection statistics. 

— u hr Gather the traffic statistics over the past hr hours. 

—csys Exercise the connection to the system sys. If .sys is specified as all, 
then exercise the connection to all the systems in the subnetwork. 

The meanings of the connections report are: 

sys #call #ok time #dev #login #nack #other 

where sys is the remote system name, #call is the number of times the local 
system tries to call sys since the last flush was done, and #ok is the number of 
successful connections, time is the latest successful connect time, #dev is the 
number of unsuccessful connections because of no available device (e.g., ACU), 
#login is the number of unsuccessful connections because of login failure, 
#nack is the number of unsuccessful connections because of no response (e.g., 
line busy, system down), and #other is the number of unsuccessful connections 
because of other reasons. 

The meanings of the traffic statistics are: 
sfile sbyte rfile rbyte 

where sfile is the number of files sent and sbyte is the number of bytes sent 
over the period of time indicated in the latest uusub command with the —uhr 
option. Similarly, rfile and rbyte are the numbers of files and bytes received. 

The command: 

uusub — c all — u 24 

is typically started by cron (1M) once a day. 

FILES 

/usr/spool/uucp/SYSLOG system log file 

/usr/lib/uucp/L_sub connection statistics 

/usr/lib/uucp/R_sub traffic statistics 

SEE ALSO 

uucp(lC), uustat(lC). 
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NAME 

vlx — VAX-1 1/780 LSI console floppy interface 

SYNOPSIS 

vlx key [ files ] 

DESCRIPTION 

Vlx is used to maintain the console floppy. The floppy is in DEC RT-11 format. 
Hence, a file name is restricted to a 1- to 6-character alphanumeric name 
optionally followed by a . character separator and a 1- to 3-character 
alphanumeric extension. Upper and lower cases are mapped together. Only 
the last component of a path name is used. 

Key is one character from the set drtx, optionally concatenated with one or 
both of vf. The meanings of the key characters are: 

d Delete the named files from the floppy, 
r Replace the named files on the floppy. 

t Print a table of contents of the floppy. If no names are given, all files are 
tabled. If names are given, only those files are tabled. 

x Extract the named files from the floppy. If no names are given, all files 
are extracted. 

v Verbose. When used with t, it gives a long listing of all information about 

the files. When used with x, it precedes each file with a name. 

f Use the next name as the floppy file name, instead of the default 

/dev/conflp. 

FILES 

/dev/conflp console floppy 

SEE ALSO 

780ops(8). 

BUGS 

Dependent on knowledge and correctness of DEC software. 
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NAME 

vpmc — compiler for the virtual protocol machine 
SYNOPSIS 

vpmc [ — mcxfrt ] [ — s sfile ] [ —1 lfile ] [ — i ifile ] [ — o ofile ] file 
DESCRIPTION 

Vpmc is the compiler for a language that is used to describe communications 
link protocols. The language accepted by vpmc is a subset of C, although RAT- 
FOR may still be used with the -f option. The output of vpmc is a load 
module for the virtual protocol machine (VPM), which is a software construct 
for implementing communications link protocols (e.g., BISYNC) on the DEC 
KMC11 microprocessor. VPM is implemented by an interpreter in the KMC11 
which cooperates with a driver in the UNIX system host computer to transfer 
data over a communications link in accordance with a specified link protocol. 
UNIX system user processes transfer data to or from a remote terminal or com- 
puter system through VPM using normal UNIX system open, read, write, and 
close operations. The VPM program in the KMC11 provides error control and 
flow control using the conventions specified in the protocol. 

There are two versions of the interpreter. The appropriate version for a partic- 
ular application is selected by means of the — i option. The BISYNC version 
(-i bisync) supports half-duplex, character-oriented protocols such as the vari- 
ous forms of BISYNC. There is a separate BISYNC interpreter for the KMS11 
eightline multiplexor; this version is selected by — i bisync/kms. The HDLC 
version (— i hdlc) supports full-duplex, bit-oriented protocols such as HDLC. 
The HDLC interpreter for the KMS11 is selected by -i hdlc/kms. The com- 
munications primitives used with the BISYNC version are character-oriented 
and blocking; the primitives used with the HDLC version are frame-oriented 
and non-blocking. 

Options 

The meanings of the command-line options are: 

-m Use m4(\) instead of the C macro preprocessor. 

-c Compile only (suppress the assembly and linking phases). 

-x Retain the intermediate files used for communication between 

passes. 

— f Perform RATFOR compilation (default C ). 

-r Produce RATFOR output on standard output and suppress the 

remaining compiler phases. 

— t Permit users to supply their own translation tables for use by the 

atoe and etoa primitives. If this option is used, then the file 
astoeb.h and the file eb to as.h must be supplied by the user for 
use by the atoe and etoa primitives, respectively, and these files 
must be located in the user’s current working directory. If the — t 
option is not specified, then the atoe and etoa primitives will use the 
tables designed for the RJE application (located at 
/usr/lib/vpm/kmc/atoetbl.h and /usr/lib/vpm/kmc/etoatbl.h ) as a 
default. 

-s sfile Save the generated VPM assembly language on file sfile. 

—1 Ifile Produce a VPM assembly-language listing on file lfile. 

— i ifile Use the interpreter version specified by ifile (default bisync). 

— o ofile Write the executable object file on file ofile (default a.out). 

These options may be given in any order. 

Programs 

Input to vpmc consists of a declaration section followed by one or more func- 
tion definitions. The first defined function is invoked (on command from the 
UNIX system VPM driver) to begin program execution. 
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expression \ \ expression 

unary: 

primary 

name() 

systemcall 

++lvalue 

lvalue 

(< expression ) 

\unary 

~unary 

primary: 

name 

namelconstant ] 

nameiname] 

constant 

lvalue: 

name 

name[constant] 

namelname] 

binop: 

+ - | & &~ ''«»==!=> < > = 
< = 

Constants 

A constant is a decimal, octal, or hexadecimal integer, or a single character 
enclosed in single quotes. A token consisting of a string of digits is taken to be 
an octal integer if the first digit is a zero, otherwise the string is interpreted as 
a decimal integer. If a token begins with Ox or OX, the remainder of the token 
is interpreted as a hexadecimal integer. The hexadecimal digits include a 
through f or, equivalently, A through F. Constants used in macros and expres- 
sions are not evaluated until assemble time, thus all constants are treated as 8- 
bit quantities. 

Names 

A name is a sequence of letters, digits and underscores; the first character must 
be a letter. Upper- and lower-case letters are considered to be distinct. Names 
longer than 3 1 characters are truncated to 3 1 characters. 

System Calls 

A VPM program interacts with a communications device and a driver in the 
host computer by means of system calls (primitives) . 

The following primitives are available only in the BISYNC version of the inter- 
preter: 

atoe (expression ) 

Translate ASCII to EBCDIC. The returned value is the EBCDIC 
character that corresponds to the ASCII character represented by the 
value of the expression. The translation tables reflect the prejudices of 
a particular installation. 

crc 1 6 ( expression ) 

The value of the expression is combined with the cyclic redundancy 
check-sum at the location passed by a previous crcloc system call. The 
CRC-16 polynomial Ge 16 +Jt 15 +x 2 +l) is used for the check-sum cal- 
culation. 

crcloc(nawe) 

The two-byte array starting at the location specified by name is 
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xeom (constant) 

Transmit end-of-message. The value of the constant is transmitted, 
then the transmitter is shut down. 

xmt {expression) 

Transmit a character. The value of the expression is transmitted over 
the communications line. If the output silo is full, the process waits 
until there is room in the silo. 

xsom (constant) 

Transmit start-of-message. The transmitter is cleared, then the value 
of constant is transmitted six times. This call is used to synchronize 
the local transmitter and the remote receiver at the beginning of a 
frame. 

The following primitives are available only with the HDLC version of the inter- 
preter: 

abtxfrmO 

The current transmission, if any, is aborted, if possible, by sending a 
frame-abort sequence (seven one bits, followed immediately by a ter- 
minating flag). This operation is not feasible with some hardware 
interfaces, in which case this primitive is a no-operation. 

getxfrm ( expression ) 

Get a transmit buffer. If the transmit-bufTer queue is not empty, the 
buffer at the head of the queue is removed from the queue and 
attached to the sequence number specified by the value of the expres- 
sion. If the sequence number is greater than seven or the sequence 
number already has a buffer attached, the process is terminated in 
error. The returned value is zero if a buffer was obtained, otherwise 
non-zero. 

norbufO 

Test for the availability of an empty receive buffer. The returned value 
is true (non-zero) if the queue of empty receive buffers is currently 
empty; otherwise the returned value is false (zero). 

rcvfrm (name) 

Get a completed receive frame. If the queue of completed receive 
frames is non-empty, the frame at the head of the queue is removed 
and becomes the current receive frame. If a frame is obtained, the 
first five bytes of the frame are copied into the array specified by 
name. The returned value is true (non-zero) if a frame was obtained; 
otherwise, it is false (zero). The rightmost four bits of the returned 
value indicate the frame length as follows: if the value of the right- 
most four bits is equal to fifteen, the frame length is greater than or 
equal to 15; otherwise the frame length is equal to the value of the 
rightmost four bits. The frame length includes the two CRC bytes at 
the end of the frame and any control information at the beginning of 
the frame. Bytes following the first two bytes of the frame, but not 
including the two CRC bytes, are copied into a receive buffer, if one is 
available at the time the frame is received. Bit 020 of the returned 
value is zero if a receive buffer was available, otherwise non-zero. The 
values of the leftmost three bits of the returned value are currently 
unspecified. If a frame was obtained, the first five bytes of the frame 
are copied into the array specified by name. Frames with errors are 
discarded; a count is kept for each type of error. Frames may be dis- 
carded for any of the following reasons: (1) CRC error, (2) frame too 
short (less than four byles), (3) frame too long (buffer size exceeded), 
or (4) no receive buffer available, if a frame with a buffer attached 


- 5 - 



- 9 - 
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asserted. If the modem-ready signal subsequently drops, the process is 
terminated. If dsrwait is never invoked, the modem-ready signal is 
ignored. 

exit ( expression ) 

Terminate execution. The process is halted and the value of the 
expression is passed to the driver. 

getcmd(name) 

Get a command from the driver. If a command has been received 
from the driver since the last call to getcmd, four bytes of command 
information are copied into the array specified by name and a value of 
true (non-zero) is returned. If no command is available, the returned 
value is false (zero). 

getoptC ) 

Get the script options. Script options are passed from the protocol 
driver to the VPM interpreter by means of the common synchronous 
interface (CSI). These bits are recorded by CSI; the most recent value 
is passed to the VPM interpreter each time the protocol script is 
started. This value is saved by the interpreter and can be retrieved as 
many times as desired using the getopt primitive. The low-order bit of 
this value is used by the BX.25 level 2 script (cslapb.r) to determine 
whether to use address A or address B. 

pause 0 

Return control to the dispatcher. This primitive informs the dispatcher 
that the virtual process may be suspended until the next occurrence of 
an event that might affect the state of the protocol for this line. Exam- 
ples of such events are: (l) completion of an output transfer, (2) com- 
pletion of an input transfer, (3) timer expiration, and (4) a buffer-in 
command from the driver. In a multi-line implementation, the pause 
primitive allows the process for a given line to give up control to allow 
the processor to service another line. In a single-line implementation 
this primitive has no effect. 

snap {name) 

Create a snap event record. Four bytes from the array specified by 
name are passed to the driver, which prefixes a sequence number and 
creates a trace event record containing the data. If minor device 0 of 
the trace driver is currently open, then a time stamp is also prefixed to 
the record, and the record is placed on the read queue for that device. 
Otherwise the event record is discarded. Information passed via the 
snap primitive can be displayed using the vpmsave and vpmfmt com- 
mands (see vp/nsaveGM)). The process delays until the values have 
been accepted by the host computer. 

stmptiname) 

Return a report to the driver. Four bytes from the array specified by 
name are transferred to the driver. The process delays until the 
transfer is complete. 

testop (expression) 

Test for odd parity. The returned value is true (non-zero) if the value 
of the expression has odd parity, otherwise the returned value is false 
(zero) . 

timeout (expression) 

Schedule or cancel a timer interrupt. If the value of the expression is 
non-zero, the current values of the program counter and stack pointer 
are saved and a timer is loaded with the value of the expression. The 
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EXAMPLES 

These examples require the use of the — m option. 

# The function defined below transmits a frame in transparent BISYNC. 

# A transmit buffer must be obtained with getxbuf before the function 

# is invoked. 

# 

# Define symbolic constants: 

# 

define(DLE,OxlO) 
define (ETB, 0x26) 
define(PAD,Oxff) 
define (STX, 0x02) 
define(SYNC,0x32) 

# 

# Define a macro with an argument: 

# 

define (xmtcrc, (ere 1 6 ($ 1 ) ; xmt ($ 1 ) ;)) 

# 

# Declaration section: 

# 

unsigned char crc[2], byte, c, d; 

# 

# Define the function: 

# 

xmtblkO 

I 

crcloc(crc); 
xsom(SYNC); 
xmt(DLE); 
xmt (STX); 

while(get(&byte)==0) ( 
if(byte == DLE) 

xmt(DLE); 

xmtcrc(byte); 

} 

xmt(DLE); 
xmtcrc (ETB); 
xmt(crc[0]); 
xmt(crc[l]); 
xeom(PAD); 

} 

# 

# The following example illustrates the use of macros to simulate a 

# function call with arguments. 

# 

# The macro definition: 

# 

define (xmtctl, {c=$ 1 ;d=$2;xmtctl 1 ( ) ;} ) 

# 

# The function definition: 

# 

xmtctl 1 () 

( 

xsom(SYNC); 

xmt(c); 

if(d!=0) 
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NAME 

vpmsave, vpmfmt — save and print VPM event traces 
SYNOPSIS 

/etc/vpmsave mask device 
/etc/vpmfmt [ — t] 

DESCRIPTION 

Vpmsave opens the minor device of the trace driver specified by device , enables 
the channels specified by mask (octal), and then reads event records and writes 
them to its standard output (unformatted) until killed. Bit 0 of mask enables 
channel zero, bit 1 channel one, etc. The Common Synchronous Interface 
(CSl) routines and the CSI-based protocol drivers use the CSI index number 
(modulo 16) to select their trace channels. Each protocol driver provides an 
ioctl command that can be used to get this number. 

Vpmfmt reads its standard input, which it assumes was generated by vpmsave, 
and prints it (formatted) to its standard output until killed. The — t option 
when used, with the level 2 script trcslapb.r provides a detailed event trace of 
the operation of level 2 of BX.25. When used with other scripts the result may 
not be meaningful. 

Support for the commands vpmtrace and vpmsnap has been dropped. The 
function of vpmtrace can be obtained using vpmsave and vpmfmt as follows: 

vpmsave mask device | vpmfmt 
where device is the name of minor device 0 of the trace driver. 

The event records generated by calls to the vpmc snap primitive are now 
directed to minor device 0 along with other event records. The need to keep 
the snap event record separate no longer exists since all event records now con- 
tain a time stamp. 

EXAMPLE 

vpmsave mask device > t & 
vpmfmt < t 

SEE ALSO 

vpmc(lM), trace(7), vpm(7). 
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NAME 

vpmtest — test KMC lines 
SYNOPSIS 

/etc/vpmtest — t top — k kmc — n line 
DESCRIPTION 

Vpmtest performs a series of loopback tests on a specified synchronous line 
interface of a specified KMC. 

Top is a path name that specifies the VPM protocol driver minor device to be 
used for the test. 

Kmc is the path name for the KMC on which the test is to be run. 

Line specifies the particular line number (0-7) on a KMS; for a KMC equipped 
with a single-line line interface line should be 0. 

The KMC must have been previously loaded with the LAPB script ( cslapb.r ) 
using vpmstart. The top device must not be open for reading or writing; this is 
the same restriction as for doing a vpmseti 1M). The equivalent of a vpmset is 
performed to associate the specified top device with the specified KMC and line 
number. 

The first test uses the maintenance mode of the line unit hardware to perform 
an internal loopback test; this test is independent of the modem to which the 
line is attached. A failure at this point indicates a problem with the KMC or 
line unit hardware or with the VPM or KMC software. The second test requires 
the local (near end) modem to be placed in the analog loopback mode; on a 
AT&T 209A dataset this is accomplished by depressing the AL button on the 
front of the dataset. A failure at this point indicates a problem with the 
modem or with the interface between the modem and the line unit; a faulty or 
disconnected cable is the most likely possibility. The third test performs a loop- 
back from the remote (far end) modem. This requires placing the remote 
modem in the digital loopback mode; on a AT&T 209A dataset this is accom- 
plished by depressing the DL button on the front of the dataset. The local 
(near end) modem should be in the normal mode for this test. A failure at this 
point indicates trouble with one or both of the modems or with the telephone 
line connecting them. At the end of each test the VPM error counters associ- 
ated with the particular line are printed. 

EXAMPLE 

/etc/vpmtest — t /dev/vpml — k /dev/kmc 1 — n 7 
SEE ALSO 

vpmset(lM), kmc(7), vpm(7). 
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NAME 

whodo — who is doing what 

SYNOPSIS 

/etc/ whodo 

DESCRIPTION 

Whodo produces merged, reformatted, and dated output from the who( 1) and 
ps(l) commands. 

FILES 

etc/ passwd 

SEE ALSO 

ps(l), who(l). 
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NAME 

intro — introduction to special files 
DESCRIPTION 

This section describes various special files that refer to specific hardware peri- 
pherals and UNIX system device drivers. The names of the entries are gen- 
erally derived from names for the hardware, as opposed to the names of the 
special files themselves. Characteristics of both the hardware device and the 
corresponding UNIX system device driver are discussed where applicable. 

Tape device file names are in the following format: 

/dev/{r) mt/ (c#d) #[hmll (n) 

where r indicates a raw device, c#d indicates the controller number (which is 
optionally specified by the system administrator), # is the device number, hml 
indicates the density (h (high) for 6250 bpi, m (medium) for 1600 bpi, and I 
(low density) for 800 bpi), and n indicates no rewind on close, (e.g., 
/dev/mt/2mn) 

Disk device file names are in the following format: 

/dev/{r}dsk/(r) (c#d)#s# 

where r indicates a raw interface to the disk, the second r indicates that this 
disk is on a remote system, the c#d indicates the controller number (which is 
optionally specified by the system administrator), and #s# indicates the drive 
and section numbers, respectively. 

BUGS 

While the names of the entries generally refer to vendor hardware names, in 
certain cases these names are seemingly arbitrary for various historical reasons. 
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DMC (7) 


(DEC only) 


DMC(7) 


NAME 

dmc — communications link with built-in DDCMP protocol 
DESCRIPTION 

The DMC11 allows local connection of PDP-11 and VAX systems over high- 
speed (1Mb or 56kb) links and remote connection over leased (up to 19.2kb) or 
dial-up (up to 4,800b) lines. It implements in hardware the DDCMP data-link 
protocol, which includes error control. This driver handles two DMC 11 devices. 

FILES 

/dev/dmc 

BUGS 

There are quite a few bugs in the DEC microcode for the different versions of 
the DMC11. 
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DU (7) 


(PDP-11 only) 


DU (7) 


NAME 

du — DU- 11 synchronous line interface 
DESCRIPTION 

The files duO, dul, etc., represent interfaces to synchronous modems such as the 
AT&T System 200-series synchronous DATAPHONE® data sets. Read (2) and 
write (2) calls to du? are unlimited, but work best when restricted to less than 
512 bytes. Each writei 2) call is sent as a single record. Seven bits from each 
byte are written, along with an eighth, odd-parity, bit. The “sync” characters 
must be supplied by the user. Each read (2) call returns the characters read 
from a single record. Seven bits are returned unaltered; the eighth bit is set if 
the byte was not received in odd parity. An error is returned if data-set ready 
is not present. 

FILES 

/dev/du? 

SEE ALSO 

read(2), write(2), acu(7). 
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ERR(7) 


ERR(7) 


NAME 

err — error-logging interface 
DESCRIPTION 

Minor device 0 of the err driver is the interface between a process and the 
system’s error-record collection routines. The driver may be opened only for 
reading by a single process with super-user permissions. Each read causes an 
entire error record to be retrieved; the record is truncated if the read request is 
for less than the record’s length. 

FILES 

/dev/error special file 

SEE ALSO 

errdemon(lM). 
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GT (7) 


(DEC only) 


GT (7) 


NAME 

gt — general driver for tape drives 
DESCRIPTION 

Gt provides a general interface to the TE16 and TU8 tape drives. In addition to 
the capability of mixing these mediums on the same controller, the driver will 
handle up to two controllers. 

The driver reads the tape hardware drive-type register to determine drive 
dependent attributes. Thus, the manual entries describing the above tape 
drives should be used for information regarding that particular drive. 

The configuration name of tul678 should be specified when generating a system 
with configi 1M). 

FILES 

/dev/mt/*, /dev/rmt/* 

SEE ALSO 

config(lM), master(4), ht(7), tu78(7). 
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HP(7) 


(DEC only) 


HP(7) 


NAME 

hp — RP04/RP05/RP06 moving-head disk 
DESCRIPTION 

The format for disk files is described in introll) . The origin and size of the 
sections on each drive are as follows: 

RP04/05 


section 

start 

length 

0 

0 

18392 

1 

44 

153406 

2 

201 

87780 

3 

358 

22154 

4 

- 

— 

5 

— 

— 

6 

- 

- 

7 

0 

RP06 

171798 

section 

start 

length 

0 

0 

18392 

1 

44 

322278 

2 

201 

256652 

3 

358 

191026 

4 

515 

125400 

5 

672 

59774 

6 

— 

— 

7 

0 

340670 


The start address is a cylinder address, with each cylinder containing 418 
blocks. It is extremely unwise for all of these files to be present in one installa- 
tion, since there is overlap in addresses and protection becomes a sticky matter. 

The dsk files access the disk via the system’s normal buffering mechanism and 
may be read and written without regard to physical disk records. There is also 
a “raw” interface which provides for direct transmission between the disk and 
the user’s read or write buffer. A single read or write call results in exactly one 
I/O operation and therefore raw I/O is considerably more efficient when many 
words are transmitted. 

In raw I/O the buffer must begin on a word boundary, and counts should be a 
multiple of 512 bytes (a disk block). Likewise /seek (2 ) calls should specify a 
multiple of 512 bytes. 

FILES 

/dev/dsk/*, /dev/rdsk/* 

SEE ALSO 

lseek(2), gd(7), hm(7), intro(7), rm80(7), rp07(7). 
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HT(7) 


(DEC only) 


HT(7) 


NAME 

ht — TU16/TE16 magnetic tape interface 
DESCRIPTION 

The format for tape files is described in intro( 7). These files refer to the Digi- 
tal Equipment Corporation TUI 6 magnetic tape control and transports. When 
opened for reading or writing, the tape is assumed to be positioned as desired. 
When a file is closed, a double end-of-file (double tape mark) is written if the 
file was opened for writing. If the file was normal-rewind, the tape is rewound. 
If it is no-rewind and the file was open for writing, the tape is positioned before 
the second EOF just written. If the file was no-rewind and opened read-only, 
the tape is positioned after the EOF following the data just read. Once opened, 
reading is restricted to between the position when opened and the next EOF or 
the last write. The EOF is returned as a zero-length read. By judiciously 
choosing mt files, it is possible to read and write multi-file tapes. 

A standard tape consists of several 512-byte records terminated by an EOF. To 
the extent possible, the system treats the tape like any other file. Seeks have 
their usual meaning and it is possible to read or write a byte at a time 
(although very inadvisable). 

The mt files discussed above are useful when it is desired to access the tape in a 
way compatible with ordinary files. When foreign tapes are to be dealt with, 
and especially when long records are to be read or written, the “raw” interface 
is appropriate. The associated files are located under the /dev/rmt directory. 
Each read or write call reads or writes the next record on the tape. In the 
write case the record has the same length as the buffer given. During a read, 
the record size is passed back as the number of bytes read, up to the buffer size 
specified. In raw tape I/O, the buffer must begin on a word boundary and the 
count must be even. Seeks are ignored. An EOF is returned as a zero-length 
read, with the tape positioned after the EOF, so that the next read will return 
the next record. 

FILES 

/dev/mt/* 

/dev/rmt/» 

BUGS 

If any non-data error is encountered, it refuses to do anything more until 
closed. The driver is limited to four transports. 

SEE ALSO 

gt(7), intro(7), tu78(7). 
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KMC (7) 


(DEC only) 


KMC(7) 


NAME 

kmc — KMC-1 1B/KMS1 1 microprocessor 
DESCRIPTION 

The files kmc? are used to manipulate the KMC11-B or KMS11 microprocessor. 
The device handler provides the basic mechanism needed to load, run, and 
debug programs on the microprocessor. The open is exclusive; at most one open 
at a time. 

Addresses 0—8195 reference the 4096 words of instructions in the control 
memory of the microprocessor. This portion is word oriented, that is, the 
address and byte count must be even. 

Addresses 8196—12211 reference the 4096 bytes of data in the data memory of 
the microprocessor. The data portion may be read or written with no restric- 
tions on addressing. 

The ioctl il) function is used to provide access to the basic microprocessor 
capabilities. 

#include <sys/kmc.h> 
ioctl (fildes, command, arg) 
struct kmcntl { 

int kmd; 

short *kcsr; 

int kval; 

} *arg; 

The only command available is KCSETA. The pointer kcsr contains the 
address of a 4-word buffer for the UNIBUS Control and Status Registers associ- 
ated with the microprocessor. The value of kmd determines the function: 

1 single step and return CSRs in kcsr. 

2 maintenance step: execute value and then return CSRs. 

3 return CSRs. 

4 stop: clear the run bit. 

5 reset: set then clear the master clear bit. 

6 run: set the run bit and set the software state to kval and 
running. 

7 line unit maintenance: set the line unit bits from kval. 

8 set CSR sel6 to kval. 

9 clear: first reset, then empty the input queue. 

FILES 

/dev/kmc? 

SEE ALSO 

kasb(l), ioctl (2) , dz(7), vpm(7). 
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MEMO) 


MEM (7) 


NAME 

mem, kmem — core memory 
DESCRIPTION 

Mem is a special file that is an image of the core memory of the computer. It 
may be used, for example, to examine, and even to patch the system. 

Byte addresses in mem are interpreted as memory addresses. References to 
non-existent locations cause errors to be returned. 

Examining and patching device registers is likely to lead to unexpected results 
when read-only or write-only bits are present. 

The file kmem is the same as mem except that kernel virtual memory rather 
than physical memory is accessed. 

On the PDP-11, the I/O page begins at location 0160000 of kmem and per- 
process data for the current process begins at 0140000. 

FILES 

/dev/mem, /dev/kmem 

BUGS 

On the PDP-11, memory files are accessed one byte at a time, an inappropriate 
method for some device registers. 
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NAME 

null — the null file 
DESCRIPTION 

Data written on a null special file is discarded. 
Reads from a null special file always return 0 bytes. 

FILES 

/dev/null 
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NAME 

prf — operating system profiler 
DESCRIPTION 

The file prf provides access to activity information in the operating system. 
Writing the file loads the measurement facility with text addresses to be moni- 
tored. Reading the file returns these addresses and a set of counters indicative 
of activity between adjacent text addresses. 

The recording mechanism is driven by the system clock and samples the pro- 
gram counter at line frequency. Samples that catch the operating system are 
matched against the stored text addresses and increment corresponding 
counters for later processing. 

The file prf is a pseudo-device with no associated hardware. 

FILES 

/dev/prf 
SEE ALSO 

config(lM), profiler (1M). 
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RA (7) 


becomes a sticky matter. 

The ra files access the disk via the system’s normal buffering mechanism and 
may be read and written without regard to physical disk records. There is also 
a “raw” interface which provides for direct transmission between the disk and 
the user’s read or write buffer. A single read or write call results in exactly one 
I/O operation and therefore raw I/O is considerably more efficient when many 
words are transmitted. The names of the raw RA files begin with rra and end 
with a number which selects the same disk section as the corresponding ra file. 

In raw I/O the buffer must begin on a word boundary, and counts should be a 
multiple of 512 bytes (a disk block). Likewise Iseeki 2) calls should specify a 
multiple of 512 bytes. 

FILES 

/dev/ra/*, /dev/rra/* 
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NAME 

rk - RK-11/RK03 or RK05 disk 
DESCRIPTION 

The file dsk/?sO refers to an entire RK03 disk as a single sequentially-addressed 
file. Its 256-word blocks are numbered 0 to 4871. The RK03 disk is not 
recommended. 

The rk files access the disk via the system’s normal buffering mechanism and 
may be read and written without regard to physical disk records. There is also 
a “raw” interface which provides for direct transmission between the disk and 
the user’s read or write buffer. A single read or write call results in exactly one 
I/O operation and therefore raw I/O is considerably more efficient when many 
words are transmitted. The names of the raw RK files begin with rdsk. 

In raw I/O the buffer must begin on a word boundary, and counts should be a 
multiple of 512 bytes (a disk block). Likewise lseek{2) calls should specify a 
multiple of 512 bytes. 

FILES 

/dev/rk», /dev/rrk* 

SEE ALSO 

lseek(2). 
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(DEC only) 
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NAME 

rm80 — RM80 moving-head disk 
DESCRIPTION 

The format for disk files is described in introi 7). The origin and size of the 
sections on each drive are as follows: 


section 

start 

length 

0 

0 

18228 

1 

42 

224378 

2 

194 

158410 

3 

346 

92442 

4 

C 

498 

26474 

J 

6 

— 

— 

7 

0 

242606 


The start address is a cylinder address, with each cylinder containing 434 
blocks. It is extremely unwise for all of these files to be present in one installa- 
tion, since there is overlap in addresses and protection becomes a sticky matter. 

The dsk files access the disk via the system’s normal buffering mechanism and 
may be read and written without regard to physical disk records. There is also 
a “raw” interface which provides for direct transmission between the disk and 
the user’s read or write buffer. A single read or write call results in exactly one 
I/O operation and therefore, raw I/O is considerably more efficient when many 
words are transmitted. 

In raw I/O the buffer must begin on a word boundary, and counts should be a 
multiple of 512 bytes (a disk block). Likewise Iseekti) calls should specify a 
multiple of 512 bytes. 

FILES 

/dev/dsk/*, /dev/rdsk/* 

SEE ALSO 

lseek(2), gd(7), hm(7), hp(7), intro(7), rp(7), rp07(7). 
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(VAX-11/780 only) 
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NAME 

rp07 — RP07 non-removable medium moving-head disk 
DESCRIPTION 

The format for disk files is described in introi 7). The origin and size of the 
sections on each drive are as follows: 


section 

start 

length 

0 

0 

64000 

1 

40 

944000 

2 

105 

840000 

3 

210 

672000 

4 

315 

504000 

5 

420 

336000 

6 

525 

168000 

7 

0 

1008000 


The start address is a cylinder address, with each cylinder containing 1600 
blocks. It is extremely unwise for all of these files to be present in one installa- 
tion, since there is overlap in addresses and protection becomes a sticky matter. 

The dsk files access the disk via the system’s normal buffering mechanism and 
may be read and written without regard to physical disk records. There is also 
a “raw” interface which provides for direct transmission between the disk and 
the user’s read or write buffer. A single read or write call results in exactly one 
I/O operation and therefore, raw I/O is considerably more efficient when many 
words are transmitted. 

In raw I/O the buffer must begin on a word boundary, and counts should be a 
multiple of 512 bytes (a disk block). Likewise /seek (2) calls should specify a 
multiple of 512 bytes. 

FILES 

/dev/dsk/*, /dev/rdsk/» 

SEE ALSO 

lseek(2), gd(7), hm(7), hp(7), intro(7), rp(7), rm80(7). 
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SXT(7) 


SXTIOCUBLK Turn off the loblk control flag in the virtual tty of 
the indicated channel. The error EINVAL will be 
returned if an invalid number or channel 0 is 
given. 

SXTIOCSTAT Get the status (blocked on input or output) of 
each channel and store in the sxtblock structure 
referenced by the argument. The error EFAULT 
will be returned if the structure cannot be written. 


SXTIOCTRACE Enable tracing. Tracing information is written to 
/dev/osm on the 3B 20 computer or to the console 
on the VAX. This command has no effect if trac- 
ing is not configured. 

SXTIOCNOTRACE Disable tracing. This command has no effect if 
tracing is not configured. 

FILES 

/dev/sxt/??[0-7] Virtual tty devices 

/usr/include/sys/sxt.h Driver specific definitions. 

SEE ALSO 

shl(l), stty(l), ioctl (2) , open(2), termio(7). 
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(#) erases the preceding character. It will not erase beyond the start 
of a line, as delimited by a NL, EOF, or EOL character. 

(@) deletes the entire line, as delimited by a NL, EOF, or EOL char- 
acter. 

(Control-d or ASCII EOT) may be used to generate an end-of-file 
from a terminal. When received, all the characters waiting to be 
read are immediately passed to the program, without waiting for a 
new-line, and the EOF is discarded. Thus, if there are no characters 
waiting, which is to say the EOF occurred at the beginning of a line, 
zero characters will be passed back, which is the standard end-of-file 
indication. 

(ASCII LF) is the normal line delimiter. It cannot be changed or 
escaped. 

(ASCII NUL) is an additional line delimiter, like NL. It is not nor- 
mally used. 

(Control-s or ASCII DC3) can be used to temporarily suspend output. 
It is useful with CRT terminals to prevent output from disappearing 
before it can be read. While output is suspended, STOP characters 
are ignored and not read. 

(Control-q or ASCII DCl) is used to resume output which has been 
suspended by a STOP character. While output is not suspended, 
START characters are ignored and not read. The start/stop charac- 
ters cannot be changed or escaped. 

The character values for INTR, QUIT, SWTCH, ERASE, KILL, EOF, and EOL 
may be changed to suit individual tastes. The ERASE, KILL, and EOF charac- 
ters may be escaped by a preceding \ character, in which case no special func- 
tion is done. 

When the carrier signal from the data-set drops, a hang-up signal is sent to all 
processes that have this terminal as the control terminal. Unless other arrange- 
ments have been made, this signal causes the processes to terminate. If the 
hang-up signal is ignored, any subsequent read returns with an end-of-file indi- 
cation. Thus, programs that read a terminal and test for end-of-file can ter- 
minate appropriately when hung up on. 

When one or more characters are written, they are transmitted to the terminal 
as soon as previously-written characters have finished typing. Input characters 
are echoed by putting them in the output queue as they arrive. If a process 
produces characters more rapidly than they can be typed, it will be suspended 
when its output queue exceeds some limit. When the queue has drained down 
to some threshold, the program is resumed. 

Several ioctli.2 ) system calls apply to terminal files. The primary calls use the 
following structure, defined in <termio.h>: 


#define NCC 

8 



struct termio { 




unsigned 

short 

ciflag; 

/* input modes •/ 

unsigned 

short 

c_oflag; 

/* output modes •/ 

unsigned 

short 

ccflag; 

/* control modes */ 

unsigned 

short 

cjflag; 

/* local modes */ 

char 


c_line; 

/ * line discipline */ 

unsigned 

}; 

char 

c_cc[NCCl; 

/* control chars */ 
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ERASE 

KILL 

EOF 

NL 

EOL 

STOP 

START 
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The initial input control value is all-bits-clear. 

The c oflag field specifies the system treatment of output: 


OPOST 

0000001 

Postprocess output. 

OLCUC 

0000002 

Map lower case to upper on output. 

ONLCR 

0000004 

Map NL to CR-NL on output. 

OCRNL 

0000010 

Map CR to NL on output. 

ONOCR 

0000020 

No CR output at column 0. 

ONLRET 

0000040 

NL performs CR function. 

OFILL 

0000100 

Use fill characters for delay. 

OFDEL 

0000200 

Fill is DEL, else NUL. 

NLDLY 

0000400 

Select new-line delays: 

NLO 

0 


NL1 

0000400 


CRDLY 

0003000 

Select carriage-return delays: 

CRO 

0 


CR1 

0001000 


CR2 

0002000 


CR3 

0003000 


TABDLY 

0014000 

Select horizontal-tab delays: 

TABO 

0 


TAB1 

0004000 


TAB2 

0010000 


TAB3 

0014000 

Expand tabs to spaces. 

BSDLY 

0020000 

Select backspace delays: 

BSO 

0 


BS1 

0020000 


VTDLY 

0040000 

Select vertical-tab delays: 

VTO 

0 


VT1 

0040000 


FFDLY 

0100000 

Select form-feed delays: 

FFO 

0 


FF1 

0100000 



If OPOST is set, output characters are post-processed as indicated by the 
remaining flags, otherwise characters are transmitted without change. 

If OLCUC is set, a lower-case alphabetic character is transmitted as the 
corresponding upper-case character. This function is often used in conjunction 
with IUCLC. 

If ONLCR is set, the NL character is transmitted as the CR-NL character pair. 
If OCRNL is set, the CR character is transmitted as the NL character. If 
ONOCR is set, no CR character is transmitted when at column 0 (first posi- 
tion). If ONLRET is set, the NL character is assumed to do the carriage-return 
function; the column pointer will be set to 0 and the delays specified for CR will 
be used. Otherwise the NL character is assumed to do just the line-feed func- 
tion; the column pointer will remain unchanged. The column pointer is also set 
to 0 if the CR character is actually transmitted. 

The delay bits specify how long transmission stops to allow for mechanical or 
other movement when certain characters are sent to the terminal. In all cases 
a value of 0 indicates no delay. If OFILL is set, fill characters will be transmit- 
ted for delay instead of a timed delay. This is useful for high baud rate termi- 
nals which need only a minimal delay. If OFDEL is set, the fill character is 
DEL, otherwise NUL. 

If a form-feed or vertical-tab delay is specified, it lasts for about 2 seconds. 
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If PARENB is set, parity generation and detection is enabled and a parity bit is 
added to each character. If parity is enabled, the PARODD flag specifies odd 
parity if set, otherwise even parity is used. 

If CREAD is set, the receiver is enabled. Otherwise no characters will be 
received. 

If HUPCL is set, the line will be disconnected when the last process with the 
line open closes it or terminates. That is, the data-terminal-ready signal will 
not be asserted. 

If CLOCAL is set, the line is assumed to be a local, direct connection with no 
modem control. Otherwise modem control is assumed. 


If LOBLK is set, the output of a job control layer will be blocked when it is not 
the current layer. Otherwise the output generated by that layer will be multi- 
plexed onto the current layer. 

The initial hardware control value after open is B300, CS8, CREAD, HUPCL. 


The cjflag field of the argument structure is used by the line discipline to con- 
trol terminal functions. The basic line discipline (0) provides the following: 


ISIG 

0000001 

ICANON 

0000002 

XCASE 

0000004 

ECHO 

0000010 

ECHOE 

0000020 

ECHOK 

0000040 

ECHONL 

0000100 

NOFLSH 

0000200 


Enable signals. 

Canonical input (erase and kill processing). 
Canonical upper/lower presentation. 

Enable echo. 

Echo erase character as BS-SP-BS. 

Echo NL after kill character. 

Echo NL. 

Disable flush after interrupt or quit. 


If ISIG is set, each input character is checked against the special control char- 
acters INTR, SWTCH, and QUIT. If an input character matches one of these 
control characters, the function associated with that character is performed. If 
ISIG is not set, no checking is done. Thus these special input functions are pos- 
sible only if ISIG is set. These functions may be disabled individually by 
changing the value of the control character to an unlikely or impossible value 
(e.g., 0377). 


If ICANON is set, canonical processing is enabled. This enables the erase and 
kill edit functions, and the assembly of input characters into lines delimited by 
NL, EOF, and EOL. If ICANON is not set, read requests are satisfied directly 
from the input queue. A read will not be satisfied until at least MIN characters 
have been received or the timeout value TIME has expired between characters. 
This allows fast bursts of input to be read efficiently while still allowing single 
character input. The MIN and TIME values are stored in the position for the 
EOF and EOL characters, respectively. The time value represents tenths of 
seconds. 


If XCASE is set, and if ICANON is set, an upper-case letter is accepted on 
input by preceding it with a \ character, and is output preceded by a \ charac- 
ter. In this mode, the following escape sequences are generated on output and 
accepted on input: 

for: use: 

' V 

I V 

V 

{ \( 

} \) 

\ w 
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NAME 

tm — TM1 1/TU10 magnetic tape interface 
DESCRIPTION 

The format for disk files is described in intro(7). The files {r)mt/#l{n} refer to 
the Digital Equipment Corporation TM11/TU10 magnetic tape control and tran- 
sports at 800bpi. When opened for reading or writing, the tape is assumed to 
be positioned as desired. When a file is closed, a double end-of-file (double 
tape mark) is written if the file was opened for writing. If the file was normal- 
rewind, the tape is rewound. If it is no-rewind and the file was open for writ- 
ing, the tape is positioned before the second EOF just written. If the file was 
no-rewind and opened read-only, the tape is positioned after the EOF following 
the data just read. Once opened, reading is restricted to between the position 
when opened and the next EOF or the last write. The EOF is returned as a 
zero-length read. By judiciously choosing mt files, it is possible to read and 
write multi-file tapes. 

A standard tape consists of several 512-byte records terminated by an EOF. To 
the extent possible, the system makes it possible, if inefficient, to treat the tape 
like any other file. Seeks have their usual meaning and it is possible to read or 
write a byte at a time (although very inadvisable). 

The mt files discussed above are useful when it is desired to access the tape in a 
way compatible with ordinary files. When foreign tapes are to be dealt with, 
and especially when long records are to be read or written, the “raw” interface 
is appropriate. The associated files are under the /dev/rmt directory. Each 
read or write call reads or writes the next record on the tape. In the write case 
the record has the same length as the buffer given. During a read, the record 
size is passed back as the number of bytes read, up to the buffer size specified. 
In raw tape I/O, the buffer must begin on a word boundary and the count must 
be even. Seeks are ignored. An EOF is returned as a zero-length read, with 
the tape positioned after the EOF, so that the next read will return the next 
record. 

FILES 

/dev/mt/*, /dev/rmt/* 

SEE ALSO 

intro(7). 

BUGS 

If any non-data error is encountered, it refuses to do anything more until 
closed. The driver is limited to four transports. 
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NAME 

ts — TS11 magnetic tape interface 

DESCRIPTION 

The format for tape files is described in introi 7). The files {r}mt/#m(n) refer 
to the Digital Equipment Corporation TS11 magnetic tape control and tran- 
sports at 1600bpi. When opened for reading or writing, the tape is assumed to 
be positioned as desired. When a file is closed, a double end-of-file (double 
tape mark) is written if the file was opened for writing. If the file was normal- 
rewind, the tape is rewound. If it is no-rewind and the file was open for writ- 
ing, the tape is positioned before the second EOF just written. If the file was 
no-rewind and opened read-only, the tape is positioned after the EOF following 
the data just read. Once opened, reading is restricted to between the position 
when opened and the next EOF or the last write. The EOF is returned as a 
zero-length read. By judiciously choosing mt files, it is possible to read and 
write multi-file tapes. 

A standard tape consists of several 512-byte records terminated by an EOF. 
The system attempts to treat a tape like a file, however the operation is 
inefficient. Seeks have their usual meaning and it is possible to read or write a 
byte at a time (although very inadvisable). 

The mt files discussed above are useful when it is desired to access the tape in a 
way compatible with ordinary files. When foreign tapes are to be dealt with, 
and especially when long records are to be read or written, the “raw” interface 
is appropriate. The associated files are under the /dev/rmt directory. Each 
read (2) or write (2) call reads or writes the next record on the tape. In the 
write case the record has the same length as the buffer given. During a read, 
the record size is passed back as the number of bytes read, up to the buffer size 
specified. In raw tape I/O, the buffer must begin on a word boundary and the 
count must be even. Seeks are ignored. An EOF is returned as a zero-length 
read, with the tape positioned after the EOF, so that the next read will return 
the next record. 

FILES 

/dev/mt/*, /dev/rmt/* 

SEE ALSO 

read (2), write(2), intro(7). 

BUGS 

If any non-data error is encountered, it refuses to do anything more until 
closed. Note that during a rewind or space-forward operation, control is not 
returned until the operation has completed. The driver is limited to one tran- 
sport. 
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NAME 

tu78 — TU78 magnetic tape interface 
DESCRIPTION 

The format for tape files is described in introd) . These files refer to the Digi- 
tal Equipment Corporation TU78 magnetic tape control and transports. When 
opened for reading or writing, the tape is assumed to be positioned as desired. 
When a file is closed, a double end-of-file (double tape mark) is written if the 
file was opened for writing. If the file was normal-rewind, the tape is rewound. 
If it is no-rewind and the file was open for writing, the tape is positioned before 
the second EOF just written. If the file was no-rewind and opened read-only, 
the tape is positioned after the EOF following the data just read. Once opened, 
reading is restricted to between the position when opened and the next EOF or 
the last write. The EOF is returned as a zero-length read. By judiciously 
choosing mt files, it is possible to read and write multi-file tapes. 

A standard tape consists of several 512-byte records terminated by an EOF. To 
the extent possible, the system makes it possible, if inefficient, to treat the tape 
like any other file. Seeks have their usual meaning and it is possible to read or 
write a byte at a time (although very inadvisable). 

The mt files discussed above are useful when it is desired to access the tape in a 
way compatible with ordinary files. When foreign tapes are to be dealt with, 
and especially when long records are to be read or written, the “raw” interface 
is appropriate. The associated files are under the /dev/rmt directory. Each 
read (2) or write (2) call reads or writes the next record on the tape. In the 
write case the record has the same length as the buffer given. During a read, 
the record size is passed back as the number of bytes read, up to the buffer size 
specified. In raw tape I/O, the buffer must begin on a word boundary and the 
count must be even. Seeks are ignored. An EOF is returned as a zero-length 
read, with the tape positioned after the EOF, so that the next read will return 
the next record. 

FILES 

/dev/mt/*, /dev/rmt/* 

BUGS 

If any non-data error is encountered, it refuses to do anything more until 
closed. The driver is limited to four transports. 

SEE ALSO 

read(2), write(2), gt(7), ht (7) , intro(7). 
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NAME 

vpm — Virtual Protocol Machine 
DESCRIPTION 

This entry describes the VPM protocol driver and gives an introduction to the 
Virtual Protocol Machine (VPM). 

VPM is a software package for implementing link-level protocols on Program- 
mable Communication Devices (PCDs) in a high-level language. This is 
accomplished by a compiler that runs on the UNIX system and translates a 
high-level language description of a protocol into an intermediate language that 
is executed by the PCD. 

The VPM software consists of the following components: 

1. A compiler (vpwc(lM)) for the protocol description language; it runs 
on the UNIX system. 

2. A program that controls the overall operation of the PCD and executes 
the protocol script. 

3. A protocol driver. 

4. vpmstarf. a UNIX system command that copies a load module into the 
PCD and starts it. 

5. vpmseti 1M): a UNIX system command that logically connects VPM 
minor devices with PCD synchronous lines. 

6. vpmsave{ 1M): a UNIX system command that writes unformatted trace 
data to its standard output. 

7. vpmfmt : a UNIX system command that formats the output of 
vpmsave (1 M). 

Operation of the VPM Protocol Driver 

The VPM protocol driver provides a simple user interface to a synchronous line 
controlled by a link-level protocol executing in a PCD. It supports the following 
UNIX system calls: vpmtestl , close2, ioctl2, open2, read 2 , and write2. If 
higher levels of protocol are required, the VPM protocol driver may be modified 
or replaced. 

The VPM protocol driver communicates with the level 2 protocol executing in 
the PCD using the Common Synchronous Interface (CSl). CSI is a device- 
independent interface between a level 3 protocol executing as part of the UNIX 
operating system and a level 2 protocol executing in a PCD. The interface con- 
sists of procedure calls implementing a number of commands and reports. 

Before a VPM protocol driver minor device can be used, it must be logically 
connected to a synchronous line of some PCD. This connection can be made by 
means of ioctl commands (see below). The command vpmseti 1M) uses these 
ioctl commands to make these connections. 

This driver allows UNIX system user processes to transfer data to or from a 
remote terminal or computer system through VPM. Flow control and error 
recovery are provided by the level 2 protocol executed by the PCD. 

The VPM protocol driver open for reading-and-writing is exclusive; opens for 
reading-only or writing-only are not exclusive. The open sends a command to 
the PCD which causes it to start executing the protocol. The protocol driver 
then supplies one or more 512-byte receive buffers to the PCD. 

The read returns either the number of bytes requested or the number remain- 
ing in the current receive buffer, whichever is less; any remaining bytes in the 
current receive buffer are used to satisfy subsequent reads. The data from each 
user write is copied into one or more 512-byte buffers and passed to the PCD 
for transmission. 
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HWLOOP— This option causes the HDLC versions of the interpreters to 
set maintenance loopback mode on the synchronous line interface asso- 
ciated with a particular line. This option is used by vpmtesti 1M). 

ADRSWTCH— This option causes the HDLC versions of the interpreters 
to invert (complement) the address bit (bit 2 of byte 0) of each 
transmitted frame. This allows the BX.25 level 2 protocol script cslapb.r 
to operate in a loopback mode. This option is used by vpmtesti 1M). 

X25MODE— If this option is set, the HDLC versions of the interpreters 
places the first three bytes of the data portion of each received frame 
into the octet portion of the buffer descriptor instead of into the data 
buffer. Similarly, the first three bytes of the data portion of each 
transmitted frame are taken from the octet portion of the buffer 
descriptor. This mode is used by the PDP-11 version of the BX.25 level 
3 driver. 

DSRMODE— This option instructs all versions of the interpreters to wait 
for the near-end modem to assert data-set-ready (modem-ready) before 
starting the execution of the link-level (level 2) protocol script. 

VPMSTAT— This puts into the integer variable pointed to by arg the CSI index 
associated with the protocol minor device. 

The VPM Event Trace 

The VPM protocol driver and CSI routines generate a number of event records 
to allow the activity of the protocol driver, the interface routines, and the moni- 
toring of the protocol script for debugging purposes. If a program such as 
vpmsavei 1M) has opened minor device 0 of the trace driver and has enabled 
the appropriate channels on that device, these event records are queued for 
reading; otherwise the event records are discarded by the trace driver. Event 
records associated with CSI interface index n modulo 16 are put on the read 
queue for minor device 0 of the trace driver with a channel number of n. Calls 
to the system functions vpmopen , vpmread , vpmwrite, and vpmclose generate 
event records identified respectively by open, read, write, and close when the 
output of vpmsave is formatted and printed by vpmfmt. Calls to the 
vpwc(lM) primitive trace (argl , arg2 ) cause the PCD to pass argl and arg2 
along with the current value of the script location counter to the VPM driver, 
which generates an event record identified by trace. 

When the script terminates for any reason, the driver is notified and generates 
an event record identified by INTterm. This record also contains the CSI minor 
device number, the script location counter, and a termination code; the code 
indicates the reason for termination as follows: 

0 Normal termination; the PCD received a HALT command from the 
driver. 

1 Undefined virtual-machine operation code. For example, running an 
HDLC script on a BISYNC interpreter. 

2 Script program counter out of bounds. 

3 Interpreter stack overflow or underflow. 

4 Jump address not even. 

5 UNIBUS error. 

6 Transmit buffer has an odd address; or the driver tried to give the PCD 
too many transmit buffers; or a get or rtnxbuf was executed while no 
transmit buffer was open, i.e., no getxbuf was executed prior to the get 
or rtnxbuf. 

7 Receive buffer has an odd address; or the driver tried to give the PCD 
too many receive buffers; or a put or rtnrbuf was executed while no 
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NAME 

intro — introduction to system maintenance procedures 
DESCRIPTION 

This section outlines certain procedures that will be of interest to those charged 
with the task of system maintenance. Included are discussions on such topics 
as boot procedures, recovery from crashes, file backups, etc. 

BUGS 

No manual can take the place of good, solid experience. 
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Table 1 — Physical Memory Selection 
Console switches < 1 5: 1 2> Physical addresses 


00 

00 

000 

000 - 

00 

157 

776 

01 

00 

200 

000 - 

00 

357 

776 

02 

00 

400 

000 - 

00 

557 

776 

03 

00 

600 

000 - 

00 

757 

776 

04 

01 

000 

000 - 

01 

157 

776 

05 

01 

200 

000 - 

01 

357 

776 

06 

01 

400 

000 - 

01 

557 

776 

07 

01 

600 

000 - 

01 

757 

776 

10 

02 

000 

000 - 

02 

157 

776 

11 

02 

200 

000 - 

02 

357 

776 

12 

02 

400 

000 - 

02 

557 

776 

13 

02 

600 

000 - 

02 

757 

776 

14 

03 

000 

000 - 

03 

157 

776 

15 

03 

200 

000 - 

03 

357 

776 

16 

03 

400 

000 - 

03 

557 

776 

17 

03 

600 

000 - 

03 

757 

776 


Table II — Device selection 


Console switches < 7:3 > 
00 
01 
02 

03 

04 

05 

06 
07 
10 
11 

12-37 


Device 

illegal 

TM11/TU10 Magnetic tape 
TC11/TU56 DECtape 
RK11/RK05 Disk pack 
RP11/RP03 Disk pack 
reserved 

RH70/TU16 Magnetic tape 
RH70/RP04 Disk pack 
RH70/RS04 Fixed head disk 
RX11/RX01 Diskette 
illegal 
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Table IV — Error halts 


Address displayed 

Test 

Subsystem under test 

17 765 004 

1 

Branch 

17 765 020 

2 

Branch 

17 765 036 

3 

Branch 

17 765 052 

4 

Branch 

17 765 066 

5 

Branch 

17 765 076 

6 

Branch 

17 765 134 

7 

Register data path 

17 765 146 

10 

Branch 

17 765 166 

11 

CPU instruction 

17 765 204 

12 

CPU instruction 

17 765 214 

13 

CPU instruction 

17 765 222 

14 

CPU instruction 

17 765 236 

14 

CPU instruction 

17 765 260 

15 

CPU instruction 

17 765 270 

16 

Branch 

17 765 312 

16 

CPU instruction 

17 765 346 

17 

CPU instruction 

17 765 360 

20 

CPU instruction 

17 765 374 

20 

CPU instruction 

17 765 450 

21 

Kernel PAR 

17 765 474 

22 

Kernel PDR 

17 765 510 

23 

JSR 

17 765 520 

23 

JSR 

17 765 530 

23 

RTS 

17 765 542 

23 

RTI 

17 765 550 

23 

JMP 

17 765 742 

25 

Main memory data compare error 

17 765 760 

25 

Main memory data compare error 

17 776 000 

25 

Main memory parity error; 

no recovery possible from this error 

17 773 644 

26 

Cache memory data compare error 

17 773 654 

26 

Cache memory no hit, recoverable 

17 773 736 

27 

Cache memory data compare error 

17 773 746 

27 

Cache memory no hit, recoverable 

17 773 764 

25/26 

Cache memory parity error, recoverable 
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UNIX system commands found in the directory /stand. To perform a file sys- 
tem consistency check, type: 

$$ /stand/fsck /dev/rpO 

To bring up the UNIX system, the operator must type unix<cr>. The system 
should come up through SINGLE USER MODE (init s, see i«/((lM)). 

This is the appropriate time to do file system backups, and /ycfc(lM) should be 
executed if it was not executed in the stand-alone section of the boot. One 
must never operate the UNIX system with a defective file system. 

After successful completion of fsck( 1M), the operator can bring the system to 
multi-user operation by executing init 2. 

Bringing the system Down 

The shutdown procedure is designed to gracefully turn off all processes and 
bring the system back to single user state with all buffers flushed. To do this 
the operator should execute shutdown (1M). If shutdown is not successful, use 
the following sequence of commands: 

killall 

sync 

telinit 6 

fsck (optional) 

The system may then be halted by typing <ctl>p. 
system Dumps 

After a system crash, the following procedure should be used to get a system 
dump on tape. 

1. Mount a tape with write ring and bring it on-line. 

2. Halt the system and enter console mode with <ctl>p. 

3. Issue the following command sequence, each command followed by <cr>: 
E/G 0 ( Keep typing E’s until all registers have been examined: RO thru 

R15 ) 

S 400 (.Start execution at 400, i.e., dump to tape) 

4. Before returning to the UNIX system, execute the stand-alone /sck(lM). 

INSTALLATION BOOT PROCEDURE 
Tape Boot 

If tape drive 0 is a TS 11 -type tape drive, use the first program provided below. 
For a TU77 tape drive, use the second program. Make sure the power-on- 
action switch in the front panel is set to ‘HALT’. Type <cr> at the end of 
each input line: 

TS11 Tape Drive 


»> H 



»>I 



»> D/G 

E 20000 

V 

V 

V 

a 

20000 F5508FD0 

a 

A 

A 

A 

+ 

D05000FF 

Q 

A 

A 

A 

+ 

F308008F 

a 

A 

A 

A 

+ 

A0B45100 

a 

A 

A 

A 

+ 

D0421002 

Q 

A 

A 

A 

+ 

0000008 F 

Q 

A 

A 

A 

+ 

8FD06180 

Q 

A 

A 

A 

+ 

80000100 

Q 

A 

A 

A 

+ 

CFDE04A1 

V 

V 

V 

a 

+ 

CA53003A 

o 

A 

A 

A 

+ 

FFFE008F 

Q 

A 

A 

A 

+ 

8FC853FF 
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<ctl>U Deletes the current input line. 

<del> Deletes the previous character. 

(E)XAMINE {address} 

Displays 8-digit hexadecimal address and its contents. 
(D)EPOSIT {address} {data} 

Enters data to address. (Refer to VAX Hardware Handbook 
for EXAMINE and DEPOSIT qualifiers.) 

(i)NITIALIZE Initializes CPU. 

(h) ALT The HALT command is implemented on the VAX-11/750 for 

the sake of consistency with the VAX-1 1/780. It does not actu- 
ally halt the CPU since the CPU must already be halted to 
respond to the command (see <ctl>P above). It does reset 
the console defaults. 

(S)TART {address} 

Initializes CPU, enters address to PC, issues CONTINUE to 
CPU, and puts console into Program I/O mode. 

(C)ONTINUE Allows the user to restart a halted program without altering 
the state of the machine. 

FILES 

/etc/shutdown 

/stand/* 

SEE ALSO 

filesave(lM), fsck(lM), init(lM), shutdown(lM), tapeboot(8). 
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This is the appropriate time to do file system backups, and /«-/fc(lM) should be 
executed if it was not executed in the stand-alone section of the boot. One 
must never operate the UNIX system with a defective file system. 

After successful completion of /scfc(lM), the operator can bring the system to 
multi-user operation by executing init 2. 

Bringing the System Down 

The shutdown procedure is designed to gracefully turn off all processes and 
bring the system back to single user state with all buffers flushed. To do this 
the operator should execute shutdown{\M) . If shutdown is not successful, use 
the following sequence of commands: 

killall 

sync 

telinit 6 

fsck (optional) 

The system may then be halted by typing the <ctl>p and H<cr> sequence. 
System Dumps 

After a system crash, the following procedure should be used to get a system 
dump on tape. 


1 . 

2 . 

3. 

4. 


5. 


Mount a tape with write ring and bring it on-line. 

Enter console mode with <ctl>p. 

After the »> prompt, halt the system with H<cr>. 

Issue the following command sequence, each command followed by <cr>: 

E R0/N:F ( Examine RO thru R15 ) 

E SP {Get the stack pointer for the next command) 

E/V @/N:3F {Examine virtual memory beginning at the address from 
the previous instruction, and continuing for the next 63 
locations; i.e., examine the stack) 


S 400 {Start execution at 400, i.e., dump to tape) 

Before returning to the UNIX system, execute the stand-alone fsck{ 1M). 


To read the dump tape into a file for examination by crash { 1M) or any other 
debugging program, use dd{ 1). For example, the following will read the dump 
and create a file named core in the current directory: 


dd if=/dev/rmtO of=core bs=16b 


System Faults 

On occasion, the UNIBUS or its devices fail in such a manner as to flood the 
console with error messages and suspend operations on UNIBUS devices. It 
may be possible under these conditions to bring the system down gracefully 
from an internal point of view by inhibiting UNIBUS interrupts and running a 
normal shutdown. The following sequence can be executed: 


<ctl>p 
»> H 

»> E 20006004 {Look at UBA control register) 

»> D * 1 {Clear the UBA) 

»> C {Return to UNIX system) 

You should now be able to login as root and run a normal shutdown sequence. 
Reboot the system by normal means, ensuring /scfc (1M) is performed. 

INSTALLATION BOOT PROCEDURES 
Tape Boot 

The floppy disk delivered with the VAX- 11/780 does not have tape-boot capa- 
bility. The user must type in a program to read the first record on tape drive 0. 
If tape drive 0 is a TE16-type tape drive, use the first program provided below. 
For a TU78 tape drive, use the second program. Make sure the auto-restart 
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»> H 

»> LINK 

«< H 
«<U 
<«1 

«< D/I 11 20003800 
<« D R0 TYPE 


«< D R1 NEXUS 


«< D R2 ADDR 


«< D R3 0 
«< D R4 0 
«< D R5 8 
«<D FP 0 
«< S 20003000 
«< WAIT DONE 
«< E SP 

«<L VMB.EXE/S:@ 

«< S @ 

«< <ctl>C 
»> 

You are now ready to boot the UNIX system. Each time it is necessary to boot 
(or reboot) the UNIX system, simply follow the sequence: 

»>P<cr> ( Execute the commands saved in floppy link file ; the 

console should echo each command in the file.) 

$$ unix<cr> (Load and execute /unix) 

UNIX system Floppy Update 

To update the console floppy for the UNIX system operation, one must have 
brought the UNIX system up by one of the initial-load procedures described 
above. The following sequence can then be executed. 

# cd /stand/conflp 

# sh update 

Update prints commentary during the update operation indicating the files that 
are being replaced or added. Finally, a new table of contents is printed and the 
available space is indicated. 

CONSOLE OPERATION 

The following is condensed from Chapter 14 of the VAX-1 1 [780 Hardware 
Handbook , DEC, 1980. 

The following are the standard console commands. The most abbreviated form 
is shown in parentheses. 

<ctl>P Causes console to exit Program I/O mode (talking to the VAX- 

1 1/780 program). This does not halt the VAX CPU. 

<ctl>U Deletes the current input line. 

<del> Deletes the previous character. 

<ctl>C Interrupts printout. 


(Save the following sequence on the floppy) 

(The prompt should change to «<) 

Halt processor 
Unjam the SBI 
Initialize the processor 
Register initialization 
Device type code 

(If disk is a M ASS BUS device, then TYPE is 0; 
if disk is an RA disk, then TYPE is II) 
NEXUS number in hex 

(Normally, for a MASSBUS disk, NEXUS is 8; 
for an RA disk. NEXUS is 3) 

UNI BUS address of boot device’s CSR 
(For a MASSBUS disk, ADDR is 0; 
normally, for an RA disk, ADDR is 3F468) 
drive number 

Software boot flags 

Set "no machine check expected" 

Start rom program 

Show address of working memory +0x200 
Load primary bootstrap 
and start it 
(Exit LINK mode) 
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NAME 

crash — what to do when the system crashes 
DESCRIPTION 

This entry gives at least a few clues about how to proceed if the system crashes. 
It cannot pretend to be complete. 

How to bring it back up. If the reason for the crash is not evident (see below 
for guidance on “evident”) you may want to try to dump the system if you feel 
up to debugging. At the moment a dump can be taken only on magtape. With 
a tape mounted and ready, stop the machine, load address 44(8) (on the PDP- 
11), 400(16) (on the VAX-11/780; see 780ops( 8)), and start. This should 
write a copy of all of core on the tape with an EOF mark. Be sure the ring is 
in, the tape is ready, and the tape is clean and new. 

In restarting after a crash, always bring up the system single-user, as specified 
in unixbootf. 8) as modified for your particular installation. Then perform an 
/rcifc(lM) on all file systems which could have been in use at the time of the 
crash. If any serious file system problems are found, they should be repaired. 
When you are satisfied with the health of your disks, check and set the date if 
necessary, then come up multi-user. 

To even boot the UNIX system at all, three files (and the directories leading to 
them) must be intact. First, the initialization program /etc/init must be 
present and executable. If it is not, the CPU will loop in user mode at location 
6(8) (PDP-11), 13(16) (VAX-1 1/780). For init to work correctly, /dev/console 
and /bin/sh must be present. If either does not exist, the symptom is best 
described as thrashing. Init will go into a fork/exec loop trying to create a 
shell with proper standard input and output. 

If you cannot get the system to boot, a runnable system must be obtained from 
a backup medium. The root file system may then be doctored as a mounted file 
system as described below. If there are any problems with the root file system, 
it is probably prudent to go to a backup system to avoid working on a mounted 
file system. 

Repairing disks. The first rule to keep in mind is that an addled disk should 
be treated gently; it should not be mounted unless necessary, and if it is very 
valuable yet in quite bad shape, perhaps it should be copied before trying sur- 
gery on it. This is an area where experience and informed courage count for 
much. 

Fsck (1M) is adept at diagnosing and repairing file system problems. It first 
identifies all of the files that contain bad (out of range) blocks or blocks that 
appear in more than one file. Any such files are then identified by name and 
fsclm requests permission to remove them from the file system. Files with bad 
blocks should be removed. In the case of duplicate blocks, all of the files 
except the most recently modified should be removed. The contents of the sur- 
vivor should be checked after the file system is repaired to ensure that it con- 
tains the proper data. (Note that running /ick(lM) with the — n option will 
cause it to report all problems without attempting any repair.) 

Fsck (1M) will also report on incorrect link counts and will request permission 
to adjust any that are erroneous. In addition, it will reconnect any files or direc- 
tories that are allocated but have no file system references to a “lost+found” 
directory. Finally, if the free list is bad (out of range, missing, or duplicate 
blocks) /scfc(lM) will, with the operators concurrence, construct a new one. 

Why did it crash ? The UNIX system types a message on the console type- 
writer when it voluntarily crashes. Here is the current list of such messages, 
with enough information to provide a hope at least of the remedy. The mes- 
sage has the form “panic: ...”, possibly accompanied by other information. 
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9 protection fault 

10 trace trap 

1 1 compatibility mode fault 

In some of these cases it is possible for octal 40 to be added into the trap type; 
this indicates that the processor was in user mode when the trap occurred. If 
you wish to examine the stack after such a trap, either dump the system or use 
the console switches to examine core. The required address mapping is 

described below. 

Interpreting dumps. All file system problems should be taken care of before 
attempting to look at dumps. The dump should be read into the file 
/usr/tmp/core; cp(\) will do. At this point, you should execute ps —el ~c 
/usr/tmp/core and who to print the process table and the users who were on at 
the time of the crash. 

Additional information for the PDP-11. You should dump (adh(Y)) the first 
30 bytes of /usr/tmp/core. Starting at location 4, the registers R0, Rl, R2, R3, 
R4, R5, SP and KDSA6 (KISA6 for 11 /40s) are stored. If the dump had to be 
restarted, R0 will not be correct. Next, take the value of KA6 (location 22(8) 
in the dump) multiplied by 100(8) and dump 2000(8) bytes starting from 
there. This is the per-process data associated with the process running at the 
time of the crash. Relabel the addresses 140000 to 141776. R5 is C’s frame or 
display pointer. Stored at (R5) is the old R5 pointing to the previous stack 
frame. At (R5)+2 is the saved PC of the calling procedure. Trace this calling 
chain until you obtain an R5 value of 141756, which is where the user’s R5 is 
stored. If the chain is broken, you have to look for a plausible R5, PC pair and 
continue from there. Each PC should be looked up in the system’s name list 
using adb{ 1) and its : command, to get a reverse calling order. In most cases 
this procedure will give an idea of what is wrong. A more complete discussion 
of system debugging is impossible. 

SEE ALSO 

adb(l), cp(l), fsck(lM), 780ops(8), unixboot(8). 
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NAME 

mk — how to remake the system and commands 
DESCRIPTION 

All source for the UNIX system is in a source tree distributed in the directory 
/usr/src. This includes source for the operating system, libraries, commands, 
miscellaneous files necessary to the running system, and procedures to create 
everything from this source. 

The top level consists of the directories cmd, lib, uts, head, and stand as well as 
commands to remake each of these “directories”. These commands are named 
:mk, which remakes everything, and mkdir where dir is the directory to be 
recreated. Each recreation command will make all or part of the piece, over 
which it has control. The command :mk will run each of these commands and 
thus recreate the whole system. 

The lib directory contains libraries used when loading user programs. The larg- 
est and most important of these is the C library. All libraries are in sub- 
directories and are created by a makefile or runcom. A runcom is a shell com- 
mand procedure used specifically to remake a piece of the system. The :mklib 
command will rebuild the libraries that are given as arguments. The argument 
\» will cause it to remake all libraries. 

The head directory contains the header files, usually found in /usr/include on 
the running system. The .mkhead command will install those header files that 
are given as arguments. The argument \* will cause it to install all header files. 

The uts directory contains the source for the UNIX operating system. The 
:mkuts command (no arguments) invokes a series of makefiles that will 
recreate the operating system. 

The stand directory contains stand-alone commands and boot programs. The 
.mkstand command will rebuild and install these programs. 

The cmd directory contains files and directories. The :mkcmd command 
transforms source into a command based upon its suffix (.1, .y, .c, .s, .sh), or its 
makefile (see make{ 1)) or runcom. A directory is assumed to have a makefile 
or a runcom that will take care of creating everything associated with that 
directory and its sub-directories. Makefiles and runcoms are named 
command. mk and command. rc respectively. 

The command :mkcmd will recreate commands based upon a makefile or run- 
com if one of them exists; alternatively commands are recreated in a standard 
way based on the suffix of the source file. All commands requiring more than 
one file of source are grouped in sub-directories, and must have a makefile or a 
runcom. C programs (.c) are compiled by the C compiler and loaded stripped 
with shared text. Assembly language programs (.s) are assembled with 
/usr/include/sys.s which contains the system call definitions. Yacc programs 
(.y) and lex programs (.1) are processed by yacc ( 1 ) and lex(l) respectively, 
before C compilation, shell programs (.sh) are copied to create the command. 
Each of these operations leaves a command in ./cmd which is then installed by 
using /etc/install. 

The arguments to :mkcmd are either command names or subsystem names. 
The subsystems distributed with the UNIX system are: acct, graf, rje, sees, and 
text. Prefacing the :mkcmd instruction with an assignment to the shell vari- 
able, $ARGS will cause the indicated components of the subsystem to be rebuilt. 
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NAME 

rje — RJE (Remote Job Entry) to IBM 

SYNOPSIS 

/usr/rje/rjeinit 

/usr/rje/rjehalt 

DESCRIPTION 

RJE is the communal name for a collection of programs and a file organization 
that allows a UNIX system, equipped with the appropriate hardware and associ- 
ated Virtual Protocol Machine (VPM) software, to communicate with IBM’s 
Job Entry Subsystems by mimicking an IBM 360 remote work station. 

Implementation 

RJE is initiated by the command rjeinit and is terminated gracefully by the 
command rjehalt. While active, RJE runs in the background and requires no 
human supervision. It quietly transmits, to the IBM system, jobs that have been 
queued by the send( 1C) command, and operator requests that have been 
entered by the rjestat ( 1 C) command. It receives, from the IBM system, print 
and punch data sets and message output. It enters the data sets into the proper 
UNIX system directory and notifies the appropriate user of their arrival. It 
stores the message output in the file resp and makes these messages available 
for public inspection, so that rjestat (1C) , in particular, may extract responses. 

Unless otherwise specified, all files and commands described below reside in 
directory /usr/rje (first exceptions: send and rjestat). 

There are two sources of data to be transmitted by RJE from the UNIX system 
to an IBM System/370. In both cases, the data is organized as files in the 
/usr/rje/squeue directory. The first are files named co* which are created by 
the inquiry command rjestat ( 1C). The second source, containing the bulk of 
the data, are files named rd* or sq* which have been created by send{ 1C) and 
queued by the program rjeqer. On completion of processing send invokes 
rjeqer. Rjeqer and rjestat 1 C inform the program rjexmit that a file has been 
queued via the file joblog. Upon successful transmission of the data to the IBM 
machine, rjexmit removes the queued file. As files are transmitted and 
received, the program rjedisp writes an entry containing the date, time, file 
name, logname, and number of records in the file acctlog, if it exists. This file 
can be used for local logging or accounting information, but is not used else- 
where by RJE. The use of this information is up to the RJE administrator. 

Each time rjeinit is invoked, the joblog file is truncated and recreated from the 
contents of the /usr/rje/squeue directory. During this time, rjeinit prevents 
simultaneous updating of the joblog file. 

Output from the IBM system is classified as either a print data set, a punch 
data set, or message output. Print output is converted to an ASCII text file 
with standard tabs. Form feeds are suppressed, but the last line of each page is 
distinguished by the presence of an extraneous trailing space. Punch output is 
converted to pnch (4) format. This classification and both conversions occur as 
the output is received. Files are moved or copied into the appropriate user’s 
directory and assigned the name prnt* or pnch*, respectively, or placed into 
user directories under user-specified names, or used as input to programs to be 
automatically executed, as specified by the user. This process is driven by the 
“usr=...” specification. RJE retains ownership of these files and permits read- 
only access to them. Message output is digested by RJE immediately and is not 
retained. 

A record is maintained for each job that passes through RJE. Identifying infor- 
mation is extracted contextually from files transmitted to and received from the 
IBM system. 
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programs in directory (e.g., rjel, rje2, rje3). 

device 

This is the name of the controlling VPM device, with /dev/ excised, 
peripherals 

This field contains information on the logical devices (readers, printers, 
punches) used by RJE. Each subfield is separated by :, and is 
described as follows: 

(1) Number of logical readers. 

(2) Number of logical printers. 

(3) Number of logical punches. 

Note: the number of peripherals specified for an RJE subsystem must 
agree with the number of peripherals which have been described on the 
remote machine for that line. 

parameters 

This field contains information on the type of connection to make. 
Each subfield is separated by Any or all fields may be omitted; how- 
ever, the fields are positional. All but trailing delimiters must be 
present. For example, in 

1 200:5 12:::9-555-1212 

subfields 3 and 4 are missing, but the delimiters are present. Each 
subfield is defined as follows: 

(1) space 

This subfield specifies the amount of space (s) in blocks that 
RJE tries to maintain on file systems it touches. The default is 
0 blocks. Send will not submit jobs, and rjeinit issues a warn- 
ing when less than 1.55 blocks are available; rjerecv stops 
accepting output from the host when the capacity falls to 5 
blocks; RJE becomes dormant, until conditions improve. If the 
space on the file system specified by the user on the “usr=” 
card would be depleted to a point below 5, the file will be put 
in the job subdirectory of the connection’s home directory, 
rather than in the place that the user requested. 

(2) size 

This subfield specifies the size in blocks of the largest file that 
can be accepted from the host without truncation taking place. 
The default is no truncation. 

(3) badjobs 

This subfield specifies what to do with undeliverable returning 
jobs. If an output file is undeliverable for any reason other 
than file system space limitations (e.g., missing or invalid 
“usr=” card) and this subfield contains the letter y, the output 
will be retained in the job subdirectory of the home directory, 
and login rje is notified. If this subfield contains an n or has 
any other value, undeliverable output will be discarded. The 
default is n. 

(4) console 

This subfield specifies the status of the interactive status termi- 
nal for this line. If the subfield contains an i, all console status 
facilities are inhibited (e.g., rjestat(\C~) will not behave like a 
status terminal). In all cases, the normal non-interactive uses 
of rjestati. 1C) will continue to function. The default is y. 
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(PDP-11 only) 


ROM BOOT (8) 


NAME 

romboot — special ROM bootstrap loaders 
DESCRIPTION 

To bootstrap programs from various storage media, standard DEC ROM 
bootstrap loaders are often used. However, such standard loaders may not be 
compatible with the UNIX system bootstrap programs or may not exist on a 
particular system. Thus, special bootstrap loaders were designed that may be 
cut into a programmable ROM (M792 read-only-memory) or manually toggled 
into memory. 

Each program is position-independent, that is, it may be located anywhere in 
memory. Normally, it is loaded into high core to avoid being overwritten. 
Each reads one block from drive 0 into memory starting at address 0 and then 
jumps to address 0. To minimize the size, each assumes that a system INIT 
was generated prior to execution. Also, the address of one of the device regis- 
ters is used to set the byte count register or word count register. In each case, 
this will read in at least 256 words, which is the maximum size of bootstrap 
programs. 

On disk devices, block 0 is read; on tape devices, one block from the current 
position. Thus, the tape should be positioned at the load point (endzone if 
DECtape) prior to booting. Also, the standard DEC bootstrap loader for mag- 
netic tape may be emulated by positioning the tape at the load point and exe- 
cuting the bootstrap loader twice. 

By convention, on PDP 11/45 systems, address 773 000 is the start of a tape 
bootstrap loader, and 773 020 the start of a disk bootstrap loader. The actual 
loaders used depend on the particular hardware configuration. 

SEE ALSO 

70boot(8), unixboot(8). 

CODE 

TC11 — DEC tape 


012700 

mov 

$tcba,r0 


177346 




010040 

mov 

rO-(rO) 

/use tc addr for wc 

012740 

mov 

$3,-(r0) 

/read bn forward 

000003 




105710 1: 

tstb 

(rO) 

/wait for ready 

002376 

bge 

lb 


112710 

movb 

$5,(r0) 

/ read forward 

000005 




105710 1: 

tstb 

(rO) 

/wait for ready 

002376 

bge 

lb 


005007 

clr 

pc 

/transfer to zero 

TU10 — Magnetic Tape 



012700 

mov 

$mtcma,r0 


172526 




010040 

mov 

rO-(rO) 

/use mt addr for be 

012740 

mov 

$60003,- (rO) 

/read, 800 bpi, 9 track 

060003 




105710 1: 

tstb 

(rO) 

/wait for ready 

002376 

bge 

lb 


005007 

clr 

pc 

/transfer to zero 
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(PDP-11 only) 


TAPE BOOT (8) 


NAME 

tapeboot — magnetic tape bootstrap program 
DESCRIPTION 

Tapeboot handles the problem of booting a PDP-11/45 or PDP-11/70 from a 
TU10 or TUI 6 tape transport. The TUI 6 is recommended while the TU10 is not 
recommended. In both cases, the tape density is 800 bpi. The complete pro- 
gram fits in one 512-byte block, but is duplicated so that one copy resides in 
block 0 and another in block 1. Thus, both the standard DEC ROM bootstrap 
loaders and the special ROM loaders will work. For example, to create a boot 
tape, execute: 

cat /stand/tapeboot program-to-boot >/dev/mt/0m 

To boot from magnetic tape, read the first record of the tape into memory 
starting at address 0 and then jump to address 0, using a special ROM or some 
manual procedure (toggle in the program). The bootstrap program relocates 
itself to high core as specified when assembled (typically 24K words, maximum 
of 28K). It then determines whether to use the TU10 code or the TU16 code. 
The TU10 is used if the TM11 command register (772 522) exists and the func- 
tion (bits <3:1 >) is non-zero, otherwise the TU16 is used. It then types on the 
console UNIX system tape boot loader, rewinds the tape, reads two blocks to 
skip past itself on the tape, clears memory, and reads the rest of the tape, to 
the tape mark, into memory starting at address 0. If address 0 contains 
000 407, a UNIX system a.out program is assumed and the first 8 words are 
stripped off by relocating the loaded program toward address 0. Finally, a 
jump to address 0 is done by executing jsr pc,*$0. 

If there is an error while reading the tape, the bootstrap program will type 
tape error and attempt to read the record again. 

FILES 

/stand/tapeboot TU10/TU16 magtape bootstrap 
/usr/src/stand source directory 

SEE ALSO 

unixboot(8). 
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